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hanks to Raspberry Pi, the home computer is once again 
T a versatile thing. You can turn Raspberry Pi into a desktop 
computer, learn to code, play with electronics, and make handy 
household devices such as voice assistants and kitchen gadgets. 
And you can build a media player (page 31). It’s obvious when you 
think about it: Raspberry Pi is small, quiet and powerful, it connects 
to a screen using HDMI (perfect for televisions), and is packed with 
wireless LAN and Bluetooth connectivity — ideal for streaming media 
and channel surfing from a wireless controller. 
In recent issues, we’ve looked a lot at Raspberry Pi 4. With its super- 
fast CPU and an amazing amount of RAM, it’s the best computer we’ve 
ever used. But one small feature also makes it the best media playback 


device, and that’s 4K. Hook a Raspberry Pi 4 up to a 4K monitor and you 


can immediately start streaming and playing your high-quality video. 
And that’s on top of photo, music, and audiobook playback. 
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Lucy 
Hattersley 


Lucy is Editor of 
The MagPi. She 
once spent two 
weeks tuning 
school televisions 
for the council. This 
month she stressed 
out Raspberry Pi 4 
computers. 
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I love the media player project because it’s so practical. Many projects 
are designed for learning (nothing wrong with that, mind). And media 
players tend to be built, and then 
used for the long run. 

Our media player is a perfect 
example of something valuable you 
can build, with your own two hands, 
and make good use of. I hope you 
enjoy this project. 
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PRATHAM DIGI 


1g! 


NEXTHON 


collaboration success 


Empowering students to improve their own futures is key, reports Rosie Hattersley 


ver the last few months, Pratham It was established in 1995 with the aim of 
Education Foundation and Code Club providing educational opportunities for young 
have successfully piloted a programme people living in the slums of Mumbai. 
across 40 villages in rural areas of two Indian To lay the groundwork for their collaboration 
states, supporting children and young with Code Club, Pratham first held a series of 
volunteers there to get hands-on with coding. village meetings at which 16- to 25-year-olds 
Pratham (pratham.org.in) is one of India’s could sign up to become Code Club volunteers. 
largest NGOs (non-governmental organisations). They attended a training session to build their 
confidence and learn how to set up a Raspberry Pi 


computer, use Code Club Scratch projects, and 
share their coding skills with young people 
attending their Code Clubs. 

The kits needed for these Code Clubs each 
contained a Raspberry Pi computer, 
keyboard, monitor, and a mouse and were 
provided by Pratham. 


Success story 
The initiative was a remarkable success: 1109 Code 
Club members took part and 50 young adults 


Code Club members 
enjoyed learning as 
a group 
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Young Code Club members explore 
computer coding for themselves 


The dim was to introduce 
youngsters to coding and 
digital technology, while 
adults learned how to 
become Code Club leaders 


trained as volunteers. The Pratham Code Club 
project has now funded 244 Code Clubs across 40 
villages in Uttar Pradesh and Maharashtra. 

The aim was to introduce youngsters to coding 
and digital technology, while adults learned how 
to become Code Club leaders. 

One of the youth volunteers summed up the 
Code Club’s importance: “It is only because of 
these sessions that I was introduced to this world 
of computers and I know what coding means.” 

To partner with Raspberry Pi in India, 
email india@raspberrypi.org. To help 


Code Club grow in other countries, email pS VOULNNOIUNLE ST Ge monatlates 
her newly acquired coding skills 
hello@codeclubworld.org. to friends 
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Sfera introduces 
Strato P1 CM Duo 


Innovative Compute Module carrier can hold two microSD cards 


a Raspberry Pi Compute Module carrier 
module with two microSD card slots. 
The Strato Pi CM Duo features a high-speed 
switch matrix that enables a Compute Module 
3+ Lite to boot from either microSD card. With 
this architecture, Sfera claims Raspberry Pi can 
perform a full-image upgrade on one microSD 
card while the system runs from the other card. 


S fera Labs has released Strato Pi CM Duo, 


lM A robust hardware 
platform for critical edge 
computing applications 


It’s “specifically designed to create a robust 
hardware platform for critical edge computing 
applications,” Sfera tells us. 

“Edge computing solutions are often installed 
in remote locations, where physical access to the 
devices is limited and expensive, and at the 
same time are expected to have a very long 
service life.” H 
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A Strato Pi CM Duo, a Raspberry Pi 
Compute Module carrier designed 
for industrial environments 


V The CM Duo has two microSD card 
slots, creating a platform that can be 
updated while still running 
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ALBATROS 


Can you do long-term radio astronomy with a Raspberry Pi? Yes, and one maker is 
mapping out the universe and might find out how old it is. Rob Zwetsloot investigates 


An honours physics 
undergrad at McGill 
University, high- 
tech maker, and 
programmer who 
also makes games. 


mcgill.ca/mars 


One of the systems 
that collects data 
form the antenna - 
a Raspberry Pi gets 
the data which is 
then recorded ona 
hard drive 
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things in science: a backronym. It was 

originally created to mean ‘Array of Long 
Baseline Antennas for Taking Radio Observations 
from the Subantarctic’, as it started on the island 
of Marion which has a lot of albatrosses. 

“We want to make a map of the sky at low 
frequencies, to lay the groundwork for future 
observations of the cosmic ‘dark ages’ - the time 
before stars formed,” Taj Dyson tells us. He’s a 
physics student at McGill University in Canada, 
and recently took a trip to the McGill Arctic 
Research Station (MARS) to take radio astronomy 
measurements using equipment made in labs 
at McGill. 

“What does frequency have to do with time?” 
Taj continues. “To understand, realise that the 
universe was mostly neutral hydrogen. This 
hydrogen naturally emits light, or ‘glows’, at 
a wavelength of 21cm (or about 1400MHz in 
frequency). We know this frequency very precisely, 
and it’s emitted at the same frequency for all time. 
Due to the expansion of the universe, though, light 


A LBATROS is one of our favourite daft 


"] 


A A fulltest kit to see how the interference was at specific 
points in the local area 


from hydrogen that is further away is redshifted 
— that is, its frequency is reduced (in the Earth’s 
frame of reference). So, we can see light from 
hydrogen that is further away by ‘tuning’ our 
antenna lower in frequency.” 
Looking for hydrogen in this way allows us to 
look into the past of the universe. While this is 
a technique pioneered in the sixties, human- 
generated radio waves have created interference 
that make it harder to do unless you’re in remote 
areas. There are other factors as well, such as solar 
activity, that make the polar regions very attractive. 
“Getting several maps of the sky at several 
low frequencies would be the first step towards 
understanding a whole era of the universe that 
hasn’t been studied very extensively,” Taj explains, 
“laying the groundwork for future measurements 
that could provide insight into cosmological 
mysteries like dark matter or dark energy.” 


History in the stars 

At Marion Island in the subantarctic Indian Ocean, 
several radio antennas are currently in use taking 
measurements of the sky. Taj and his crew are 
looking at expanding the operation to MARS on 
the other side of the planet to create another 
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These outposts are in the middle 
of nowhere so that human-created 
radio waves are few and far between 


Amain antenna collects the 
data from the radio waves, 
feeding it to a Raspberry Pi 


The team are exploring powering the 
antenna and data collection systems 
with solar power to replace the 


generators currently used on Marion 
This method of 


measuring low 
frequencies was 
pioneered by 


The team spend summers at MARS Grote Reber 
(McGill Arctic Research Station) 
preparing the site and retrieving data 


One person stays 
at the Marion 
site each year 
to maintain 
_ the generators 


This kind of radio 
astronomy is nice 
and low-budget 


The McGill team 
were joined bya 
member of EDGES 
from MIT 


Taj has shown off 
other projects at 
Maker Faires 

in America 
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A Big crates work 
well as Faraday 
cages if you 
need one 


ALBATROS - ‘Array of Long Baseline Antennas 
for Taking Radio Observations from the Seventy- 
ninth parallel.’ 

“MARS is new to this project,” Taj says. “The 
first time we visited was last summer, and that 
was just to have a look at how much RFI [radio 
frequency interference] there is up there. A 
first look at the data suggests that MARS is very 
radio-quiet and will be an excellent place for 
future observations!” 


Mm We want to make ga map of the sky at low 
frequencies, to lay the groundwork for future 
observations of the cosmic ‘dark ages' @ 
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Next summer they will return to set up 
antennas, the data from which is processed 
through a Raspberry Pi. 

“Raspberry Pi has many desirable features 
for our application,” Taj mentions. “It 
can communicate directly with our field- 
programmable gate array (FPGA)... the very 
expensive circuit board that turns analogue 


antenna signal into zeroes and ones according to 
rules we tell Raspberry Pi to send it... Configuring 
also prints out various bits of information useful 
for troubleshooting. 

“Next, we run the actual data acquisition script 
(there are actually two types) on Raspberry Pi, 
which receives digitised signal from the FPGA 
through the Ethernet port. Raspberry Pi then 
writes that data to disk, either on the SD card for 
our small data volume mode, or on external SSDs 
for our huge ~10MB per second mode. 

“Of course, our Raspberry Pi also saves logs from 
both of these programs to the SD, so they can be 
looked at later when something doesn’t work or 
gets forgotten. Raspberry Pi consumes a relatively 
small amount of power, which is nice considering 
we want to make autonomously powered stations.” 


Cosmic patience 
An experiment like this takes time, though — you 
can’t just turn on the antennas and get an instant 
readout of the universe. It may take years. 

“The short answer is I have no idea [how long 
it will take].” Taj admits. “We are funded to go to 
MARS for two more years, but we hope this is just 


Generators provide 


the beginning of a much longer observing program. power at the moment, 
It’s going to take a lot of R&D, antennas, and time but the hope is to 

: ‘ 7 offload some of the 
to reach our ultimate goal of mapping the universe power requirements 


during cosmic dawn and the dark ages.” onvsolal 


The results will be worth the wait, however. 
“First [let’s] talk about cosmic dawn,” Taj 
continues. “When the first stars formed, their 
heat excited the hydrogen around them, causing 
it to absorb the cosmic microwave background 
(CMB) at a very specific wavelength. Since this 
event happened so long ago, the wavelength is 
now very long (again, due to redshift) and our 
low-frequency equipment can pick it up. So, we 
expect to see a slight dip in signal at a certain 
frequency (since we don’t know exactly how long 
ago this happened, we don’t know at exactly 
what frequency). [Other results] saw a dip that 
was about twice as deep as predicted, which 
means hydrogen absorbed more radiation than 
expected. This could have all sorts of cosmological 
implications. ’m not going to bet on whether 
[this] result was real or not. 

“{Secondly] the mapping of the dark ages is not 
going to test any theory; it’ll provide a baseline for 
future low-frequency measurements.” 

We look forward to seeing results in the not-so- 
far future to take a look into the very-distant past. 
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Testing the site 


“At MARS, we had a main antenna set up at 

the base camp, and that was out main data- 
gathering tool. However, we also took smaller, more 
portable antennas with us on a helicopter.” 


“[We took] a laptop and our data-gathering 

electronics - Raspberry Pi included - to take 
measurements in several different locations where 
we may put larger antennas in the future.” 


“We thought maybe local topography would 

shield us a little from RFI (it’s strange: one 
typically thinks of an observatory on a hill, but really, 
for radio astronomy, we want to be in as steep a 
valley as possible!), but we didn't see a difference 
by eye, looking at the spectra, between valleys and 
crests of hills.” 
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Cryptography ICE 
Cube experiment 


With hackers posing a potential threat to the security of satellites and space 
missions, Raspberry Pi Zero is flying into action, as David Crookes explains 


Emmanuel 
Lesser 


Emmanuelis a 
software product 
assurance engineer 
at the European 
Space Agency, 
where he provides 
software product 
assurance for 

the Copernicus 
Earth observation 
programme and the 
Biomass mission. 


esa.int/ESA 


there are some people who are determined to 

eavesdrop on communication being sent back 
and forth between Earth and orbiting satellites. 
As such, there is a danger that security and safety 
can become compromised, which is why a team of 
researchers at the European Space Agency (ESA) 
have sought to enhance cybersecurity for future 
space missions. 

“There is a risk of satellites being intercepted 
and hacked, which leaves them susceptible to being 
controlled by a rogue third party,” explains ESA 
software product assurance engineer, Emmanuel 
Lesser. “That presents a big risk for a mission and 
it’s also a problem commercially since satellites are 
very expensive and the data that is transmitted is 
sensitive. It’s important that we protect it.” 


| n space, nobody can hear you scream, but 


The right shape 

One of the cybersecurity solutions being explored 
by ESA involves Raspberry Pi Zero, and it is being 
worked on by a team headed by Emmanuel. 
Called the Cryptography ICE Cube experiment, or 
CryptIC for short, the aim is to make encryption- 
based secure communication feasible for even 
the smallest of space missions, and it is currently 
operational in the Columbus space laboratory 
module of the ISS. 


™ The aim is to make encryption-based 
secure communication feasible for even 
the smallest of space missions @ 


“We wanted the experiment to have a small 
footprint and a relatively modest energy 
consumption,” Emmanuel says. “We also wanted 
to achieve secure communication using the 
cheapest components. We knew that smaller 
missions, such as those which use CubeSats 
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A Lukas Armborst, the main engineer working on the project 
besides Emmanuel Lesser, oversees the experiment 
Image credit: ESA 


[miniaturised satellites for space research], utilise 
signals that are unencrypted. That leaves them 
vulnerable, so we looked at the possibilities.” 
Since the ICE Cubes facility in Columbus 
offers plug-and-play installation for cube-sized 
experiments, the idea was to fit CryptIC into a 
beige box measuring 10cm on all sides. “We were 
able to make use of a Raspberry Pi Zero just as it 
comes out-of-the-box,” Emmanuel says. “On that 
is a space-hardened version of Raspbian which has 
been previously commissioned by ESA. It removes 
the unnecessary parts of the system so it has fewer 
libraries, some of which we had to reinstall. But 
our main task after that was to write the software 
in Python using some of the existing libraries as 
well as our own.” 


Cryptic clues 

The project’s Raspberry Pi Zero also needed to be 
covered with a plastic ‘conformal’ coating. “This 
is an ISS requirement and it merely prevents fire 
hazards — you wouldn’t know it’s there unless 


—_ sll 
It's a very snug fit inside this | 
flight model, but the components | 
- including this FPGA board 
containing five Cmod A7 modules 
- are able to squeeze in 


— 


. ua x =< 


The WiFi-less Raspberry Pi Zero is 
coated but otherwise unmodified. It 
has the space-customised Raspbian 
Hardened operating system installed 


Communication 
with satellites isn't 
always secure 


CryptlC is a way 
of boosting 
mission safety 


The module also contains computer flash memories 
which are being evaluated for their orbital 
performance, as well as a compact ‘floating gate’ 
dosimeter developed in cooperation with CERN to 
measure radiation levels 


Its form factor is 
near-identical to 
CubeSats 


you looked really hard,” Emmanuel says. The This is connected 
computer is controlled from a laptop based on to - and powered 
Earth at ESA’s ESTEC technical centre in the By sinelse 
Netherlands, with data sent back and forth in 
near real time via the ICE Cubes operator Space 
Applications Services in Brussels. “We’re not 
sending any real sensitive data — just strings of 
‘hello world’, articles, and images,” Emmanuel 
continues. It is testing the feasibility of using a 
backup key that can’t be compromised from the 
ground, while studying whether microprocessor 
cores that are based around field-programmable 
gate arrays are able to offer redundancy if a core is 
affected by radiation.” 

The experiments began to run continuously from 
September and Emmanuel says the team is looking 
to stick with a Raspberry Pi Zero in the future too. 
“Ideally, we'd like to have more RAM and a version 
without WiFi - we had to buy an older one on 
eBay because the ISS doesn’t allow WiFi without a 
special procedure — but it’s near-perfect for what The beige box is the ICE Cube, inside which fit the components - including a Raspberry 


Pi Zero which, because it runs Linux, must (under ISS rules) also run an antivirus app 
we want,” he concludes. Image credit: ESA 


Its Raspberry Pi 
Zero is the first 
in space 
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UK train 
departure screen 


Chris 
Hutchinson 


Chris has had an 
interest in trains 
since he was a 
child and he is the 
principal engineer 
at The Times and 
The Sunday Times 
newspapers. 
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09:55:26 


Enthusiasts have expressed a 
desire to connect the project 
to bus departure times and 
non-UK railway networks 


When Chris Hutchinson had an idea to create a real-time train departure 
board, he got to work without delay, as David Crookes discovers 


expect some leaves on the line, slippery 

rain or maybe, if the weather takes a real 
turn for the worse, the wrong type of snow. But 
in any case, Chris Hutchinson will be as prepared 
as any commuter can be thanks to his Raspberry 
Pi computer. 

The railway enthusiast has developed a 
miniature real-time train departure board that 
resembles the ones adorning stations across the 
world. “I wanted to be aware of any delays or 
cancellations on the trains before heading out of 
the house,” he explains. “I knew I could use an app 
on my phone, but where’s the fun in that?” 

At first, Chris took videos of the dot matrix 
displays at the stations he visited, making a note 
of the quirks in their displays and paying attention 
to spacing and the wording they used. “I must have 
taken videos of ten or fifteen different departure 


G iven the time of year, we can perhaps 
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board variations from across the UK,” he tells 
us. “Based on those, I worked out the minimum 
dataset I’d need to display the next two services 
from my local station, and started looking into 
APIs that provided the data.” 


Tunnel vision 

Chris decided to use TransportAPI 
(transportapi.com) and he soon got down to 
coding using Python 3. He’s already found the 
perfect display for the project — a 25664 SSD1322 
OLED screen which he liked because it was 
affordable, low power, and comes in different 
colours. “The yellow one looked like a perfect 
match to the videos I had been taking,” he says. 
“So I ordered one, excitedly waited for the post 
every morning and once it arrived, I wired it up, 
got my code running, and couldn’t believe how 
brilliant it looked.” 


Making sure the screen updates 
fast enough without overpowering 
the Raspberry Pi was an important 
part of the project 


In the meantime, Chris had found an open- 
source Python library for displaying graphics on 
OLED screens ~ one he says is typically used for 
small animations or displaying debugging data. It 
also had a software simulator using Pygame under 
the hood. “It allowed me to test my code before 
the real screen arrived,” Chris recalls. He’d also 
stumbled across an open-source set of fonts that 
replicated real dot matrix departure boards and 
these only needed some tweaks to their size. 


M1 knew | could use an app 
on my phone, but where's 
the fun in that? @ 


“Most of the heavy lifting is managed in the code 
and there are two key parts to it,” Chris reveals. 
“The first is data loading and parsing, making the 
appropriate network requests for my station and 
transforming it into a useful data structure. Second 
is the rendering code where I take the data and 
turn it into pixels on the screen.” 
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Now it’s up and running, Chris keeps an eye on 
the display ahead of his daily London commute: 
“The board has prevented me from getting stuck 
out in the rain on more than one occasion.” 


On the rails 

It also seems to have struck a chord with others. 
“After I first got it up and running, I shared a 
video of the build on Twitter and the response 

was phenomenal. It turns out the crossover 
between Raspberry Pi and train enthusiasts is 
pretty significant and there are already a number 
of forks. It’s been a real honour to see so many 
people engage with the product and take it in their 
own directions.” Hl 


11:16:31 
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A Other makers have 


produced their own 
versions, including 
this one by Chris 
Crocker-White 
which incorporates a 
Raspberry Pi Zero W 


The SSD1322 OLED 
screens allow for 
different-coloured 
displays, and are 
easily connected to a 
Raspberry Pi computer 


> The screen can 
be bought for 
about £25 


> Python 3.6+ is 
needed to run 
the code 


> TransportAPI has a 
free tier for makers 


>» An API callis made 
every 1-2 minutes 


» Chris's boss wants 
one for The 
Times office 
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Thanks to BBC Box, you might be able to enjoy personalised 
services without giving up all your data. Sean McManus reports 


; 
Max Leonard 


Project Tech Lead. 
Research Engineer 
at BBC R&D. 
Responsible for the 
technical aspects of 
the project. 


Jasmine Cox 


Project User 
Experience (UX) 
Lead. Development 
Producer with BBC 
R&D. Responsible 
for producing the 
experiential and 
interaction aspects 
of prototype. 


ne day, you could watch TV shows that are 

tailored to your interests, thanks to BBC 

Box. It pulls together personal data from 
different sources in a household device, and gives 
you control over which apps may access it. 

“Tf we were to create a device like BBC Box 
and put it out there, it would allow us to create 
personalised services without holding personal 
data,” says Max Leonard. 

TV shows could be edited on the device to match 
the user’s interests, without those interests being 
disclosed to the BBC. One user might see more tech 
news and less sport news, for example. 

BBC Box was partly inspired by a change in the 
law that gives us all the right to reuse data that 
companies hold on us. “You can pull out data 
dumps, but it’s difficult to do anything with them 


a 
i 
o The LEDs illuminate 
the top witha 
colour theme that 
matches the on- 
screen interface , 
ra a 


unless you’re a data scientist,” explains Max. 
“We're trying to create technologies to enable 
people to do interesting things with their data, and 
allow organisations to create services based on that 
data on your behalf.” 


Building the box 
BBC Box is based on Raspberry Pi 3B+, the most 
powerful model available when this project 
began. “Raspberry Pi is an amazing prototyping 
platform,” says Max. “Relatively powerful, 
inexpensive, with GPIO, and able to run a proper 
OS. Most importantly, it can fit inside a small box!” 
That prototype box is a thing of beauty, a 
hexagonal tube made of cedar wood. “We created 
a set of principles for experience and interaction 
with BBC Box and themes of strength, protection, 


It was quicker, cheaper, 
and more sustainable 
to build from cedar 
than using 3D printing 


: 


: 


An Arduino Nano is used 
to control the LEDs 
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Quick FACTS 


> The pilot project 
took about 
eight weeks 


A You manage your BBC Box apps using a companion 
device with a web browser, such as a tablet 


and ownership came out very strongly,” says 
Jasmine Cox. “We looked at shapes in nature and 
architecture that were evocative of these themes 
(beehives, castles, triangles) and played with how 
they could be a housing for Raspberry Pi.” 

The core software for collating and managing 


Vv 


17 people worked 
on the pilot in total 


v 


Hook-and-loop 
tape holds 
everything 


access to data is called Databox. Alpine Linux together inside 
was chosen because it’s “lightweight, speedy but 
; aes ) - 
mHDSt importantly pete in Max's words. To get A The travel app enables people to collaborate on holiday mr ppSeah oe 
around problems making GPIO access work on planning without disclosing places they don't want to visit developed in 
Alpine Linux, an Arduino Nano is used to control Nodejs or Go 
the LEDs. Storage is a 64GB microSD card, and from BBC iPlayer and your preferred music genre 
apps run inside Docker containers, which helps to from Spotify. That unique combination of data can Pine hides 
: ‘ ‘ multicolour LEDs 
isolate them from each other. be used to recommend events you might like from illuminate the 
$ d 

i Skiddle’s database. hexagonal top 
Combining data securely Another application helps two users to plan 
The BBC has piloted two apps based on BBC Box. a holiday together. It takes their individual 


One collects your preferred type of TV programme preferences and shows them the destinations they 


lM Raspberry Pi is an amazing prototyping 
Alice’s Box platform. Most importantly, it can fit 
inside a small box! @ 


both want to visit, with information about them 

brought in from government and commercial 

sources. The app protects user privacy, because 

neither user has to reveal places they’d rather not 

visit to the other user, or the reason why. 

B The team is now testing these concepts with 

A Your data is stored on a device in your home, rather users and exploring future technology options for 
than online. You control which apps can use it BEC Box. Hl 
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Raspberry Pi’s Camera 


Module is held 


securely in place over 
the DIY aperture and 


lens filter 


DNA 
Gel Imager 


A Raspberry Pi DNA imaging setup can help reveal 
our individugl make-up, as Rosie Hattersley learns 


Dr Lindsay 
Clark 


Lindsay holds a 
PhD in Genetics. 
Her work on plant 
genetics focuses 
on environmental 
and agricultural 
issues. Her interest 
in Raspberry Pi 
began when she 
and her husband 
wanted a webcam 
that wouldn't steal 
their data. 


magpi.cc/RFqRm4 


any of us are intrigued about our 
M ancestry, with DNA testing kits showing 
how we fit in. Research labs and hospitals 
use multimillion-pound equipment for detailed 
DNA tests, but when part of the kit goes wrong, 
a low-cost alternative may be urgently needed. 
Dr Lindsay Clark found herself in exactly this 
situation when the gel imager she relied on to 
expose DNA samples broke down. She’d been 
relying on another lab’s imaging equipment in the 
first place, and “carrying somewhat hazardous 
ethidium bromide gel from place to place” had 
never been ideal. 

While we mainly think of DNA as useful for 
catching criminals and identifying possible blood 
relatives using ancestry testing kits, its main use is 
for genetic research. Cystic fibrosis researchers use 
it to test for patterns in DNA clusters, for example 
(see magpi.cc/Cmkj9F). 

Lindsay studies DNA information about 
plants, animals, and microbes. In all cases, 
the DNA material extracted needs to be 
visualised and, in this case, she needed her own 
replacement imager, fast. 

As a Raspberry Pi enthusiast, and Python and 
R programmer, she soon came up with a plan. 
Despite scant knowledge of optics, some online 
research soon gave her all the details she needed. 


Sizing things up 

“A typical gel imaging system costs tens of 
thousands of dollars, but it is essentially a camera 
mounted over a transilluminator, attached toa 


20 | magpicc | DNAGellmager 


Raspberry Pi 3B, 
Camera Module, and 
a simple spectacle 
lens are used to 
capture images from 
the transilluminator 


computer for taking digital images,” she explains. 
“We had a transilluminator we’d inherited from 
an emeritus professor. The only components left 
then were a camera and a computer, which could 
be done very cheaply with a Raspberry Pi.” Since 
Raspberry Pi uses an HDMI output, she also needed 
an HDMI to DVI converter costing a princely $8. 

“We needed to be able to take close-up, 
reasonably focused images of an orange- 
fluorescing compound, filtering out other 
wavelengths of light. The images didn’t need to be 
publication quality (we could always use another 
lab’s transilluminator if we really needed to), but 
they needed to be good enough for us to document 
approximate DNA fragment sizes.” 


Optical collusion 
Lindsay first set up her Raspberry Pi 3B camera 
kit with a fresh Raspbian installation. The only 
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The transilluminator 
displays different- 
sized DNA particles 
when exposed 


using agarose gel ai 
electrophoresis pate 


Lindsay and her 
husband bought 
Raspberry Pi boards 
as anniversary gifts 


She publishes open- 
source software 

for the genetics 
community 


She recently built a 
RetroPie for a friend 


Lindsay loves solving 
genetics’ real-world 
logic problems... 


such as DNA 
} sequence alignments 
Warning! 4 = ——-= in allopolyploid 
- 1 organisms! 


The ethidium bromide 
used in this project is a 
carcinogen. Please follow 
this project with care. 


magpi.cc/MTtK3x 
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Self-assembly time 


Set up the Raspberry Pi 3 B Camera Module 
and install Raspbian. You'll also need the 
raspistill command to trigger the Raspberry Pi camera. 


software needed was the standard raspistill 
command, so she didn’t need to write any custom 
code. The +2.00 lens used came from an old pair of 
spectacles. (A stronger lens may have worked even 
better, she thinks.) 

Lindsay then added a lens filter which she 
bought cheaply online. This was simply to cut out 
any glare from the transilluminator lamp. The 


Cut a hole in the bottom of the Styrofoam box & The gel imager needed 


to form an aperture and carve out one seating 7 a ae dee a whole setup was housed in a cut-up Styrofoam 
e transituminator é * : 
for the lens filter and a second to hold the glasses box. In all, the device cost $150 including the 
lens. Mount the Raspberry Pi camera and secure it in w Raspberry Pi 3 Camera Raspberry Pi 3 and Camera Module, monitor, 


Module was easy to 


place using paper clips or other adjustable fastening. position'in place keyboard, and mouse 
F : 


Trace around the camera filter, position one of 
the lenses in the middle of where the filter was, 
then trace around the reading glasses. 
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“The biggest challenge was making sure that it 
could focus on the gel up close,” recalls Lindsay; 
it can focus from 1m to infinity. “I tested it out by 
holding the reading glasses in front of the camera 
and taking pictures of some flyers.” The imager 
she’s built can’t zoom or focus but, as she says, 
“the camera is positioned such that it can get a 
decent picture of any gel.” 

Such has been the project’s success, Lindsay’s 
colleagues without any Raspberry Pi knowledge 
have easily made use of it too. She taped 


Carrying somewhat 
hazardous ethidium bromide 
gel from place to place had 
never been ideal! 


instructions on the wall explaining how to trigger 
the camera using Raspbian, but rarely has anyone 
asked how to use her DIY setup. 

She also encourages others to create their own 
bespoke equipment. “There’s a great tradition of 
scientists building their own equipment. Don’t let 
the existence of a commercial version deter you 
from building your own!” 


However, Lindsay warns, “Ethidium bromide 
is acarcinogen, not to mention that a lot of 
specialised equipment and reagents are needed to 
get DNA to the point where it could be visualised 
with my little imager. For example, the most 
common method of DNA extraction involves 
using chloroform in a fume hood, and then PCR 
is typically done after that before visualisation 
ona gel.” 

So the DNA gel imager isn’t something you 
could easily replicate at home. Nonetheless, 
the idea of using a Raspberry Pi for medical 
applications has merit. 


MéigPi 


Agarose gel 
helps expose 
DNA samples 
under UV light 


A visualisation 
of the CRISPR 
DNA editor 
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Social Media 
without the Internet 


Could we interact with people using social media features 
in real life? Phil King hits the ‘like’ button 


Tuang 
Thongborisute 


Raspberry Pi 
enthusiast, NCCE 
facilitator, teacher, 
and coder who 
enjoys creating new 
projects and hacks 
to inspire others to 
start learning. 


tuangstudio.com 


‘V_ Someone can press the 
shoulder pad to ‘follow’ 
the wearer; an LCD 

screen shows numbers 
followed and following 


many hours liking, following, and friending 

on social media. But have you ever pondered 
how this kind of digital interaction might transfer 
to the real world? It’s a concept that interactive 
artist Tuang Thongborisute wanted to explore, 
leading her to create the ‘Social Media without the 
Internet’ interactive performance art project. 

The original idea came from her research into 

a ‘digital sense’. “Its hypothesis says that people 
nowadays might gradually develop an additional 
sense to perceive digital contents,” she says. 


| f you’re anything like us, you probably spend 


=. 


Social Media without the Internet was created 
“to investigate people’s familiarity of social 
media’s data and interactions in the physical 
world, and to explore the digital sense by applying 
it to the sense of touch 

Part of the inspiration also came from a 
curiosity to examine society’s sceptical thoughts 


” 
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A When worn in public, the interactive blazer attracted lots of 
attention from curious people 


about the lack of physical interaction in online 
communication and to see if physical interaction is 
significant to a meaningful connection. 


Social interactions 

To explore these themes, Tuang created the ‘Social 
Touch Suit’, a blazer featuring numerous electronic 
elements — controlled by a Raspberry Pi, aided 

by an Arduino - which enable people the wearer 
meets to engage in six social interactions. 

‘Add friends’ is achieved by a handshake, 
connecting two conductive rings on the wearer’s 
fingers. “With some practice, it works naturally 
when interacting with people,” says Tuang. 

‘Unfriending’ is easy: just a push of a button 
located on the left side - “near the heart, which 
most people [have had] broken at least once ina 
lifetime anyway.” 

‘Following’ someone involves hand-holding, 
triggered by customised extendible strings with a 
microswitch. “Typically, people ask the wearer to 
follow them after they have followed the wearer 
for a while because at the end of the day, everybody 
also needs some attention back.” 

‘Follow’ is a tap on a Velostat sheet (pressure- 
conductive resistant) on the right shoulder. “A 
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The electronics 
can be removed to 
wash the blazer 


A1mstrip of 144 
RGB NeoPixels was 
used to light up 
the sleeves 


To ‘like’ the project/ 
wearer, people can tap the 
touchscreen or do a high five 


Batteries are used 
to power Raspberry 
Pi and Arduino 


The blazer's 
Raspberry Pi 
runs Python and 
Processing code 


Analogue input 
is read via an 
MCP3008 ADC 


oe = | This double dot 
' matrix display 
-* shows the number 
«4 of friends gained 
by shaking hands 


ye 


NeoPixel strips on the arms 
light up in different colours 
and patterns for each 
social interaction 
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Social Media without the Internet 


A high five is the more 
interesting way of 
adding a ‘like’, shown 
on the touchscreen 


Some of the social 
interactions possible 
by pressing various 
parts of the blazer or 
touching the hand of 
its wearer 


good follower and friend would put their hand 
gently on the wearer’s shoulder.” 

A ‘Like’ can be achieved via two interactions: 

a high-five, triggered by FSR pad attached to the 
edge of the right sleeve, or tapping a button on the 
7-inch touchscreen. 

‘Dislike’ is also done via the touchscreen — “I 
don’t remember anyone intentionally disliking me... 
except my best friends, who did it several times.” 

In addition, three tiny cameras are attached 
to the blazer, to broadcast the interaction in real 
time using a local network for performing ina 
closed environment like an indoor gallery. “This 
feature mimics an action of social media users’ 
observation on other people’s interaction without 
any interference,” says Tuang. 


Three tiny cameras are attached to the 
blazer, to broadcast the interaction in real 
time using a local network 


Out and about 
When wearing the blazer in public, Tuang found 
that people were curious or confused. “Some may 
hesitate to ask or interact, but some partake in 
face-to-face conversation,” she tells us. 
“From these experiences, I think what’s 
interesting is that these data of physical interaction 
have more potential to come from a sincere feeling 
and determination after they understand how 
it works. Because no one can give this feedback 
remotely, there’s some work that needs to be done 
to give and receive the numbers and to actually do it 
face-to-face with one another.” 
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Perpetual Chimes 


Frazer Merrick has developed a set of interactive wind chimes to 
take you away from it all. Nicola King tunes in to find out more 


When a chime hits the 
central disc, it completes 
a circuit and triggers a key 


press on the Raspberry Pi || 


| 


As they're not outside, 
the chimes rely on human 
interaction to move them 


) = 
[— l in 
he Perpetual Chimes project is very clever 
T — aset of augmented wind chimes which, 

since they are indoors, require the user to 
interact with them in order to create an escapist 
soundscape played through headphones. Frazer 
Merrick came up with the idea for the chimes while 
experimenting with ways of creating interactive 
musical instruments, and exploring how sounds 


Frazer 
Merrick Ee 


A sound artist and 
educator, Frazer 
enjoys circuit 
bending, field 
recording, and 
physical computing. 


magpi.cc/jtses3 


P Viewed from below, 
you can clearly see 
the chimes around 
the central disc 
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The atmospheric soundscape 
generated can be enjoyed by 
the user via headphones 


can transform a space. “At the time I was really 
interested in escapism,” he recalls, “so I knew I 
wanted to make a headphone-based interactive 
installation that captivated the player/listener — 
something that didn’t make much acoustic sound, 
but instead something just for the player.” 

Frazer initiated the idea back in 2016, creating 
a prototype where the chimes were suspended 
from a brake disc hanging from a mic stand. Keen 
to improve on this first version, Frazer and a 
collaborator from @LimboEducation began work 
again in 2018 to revive and improve the project: 
“We set to work making it far more robust and, 
importantly, standalone.” 


The sound of music 

So, how do the chimes work? Frazer explains, 
“When you hit one of the chimes, it strikes a disc 
in the middle. Both these elements are connected 
to a Makey Makey (the central disc being ‘earth’), 
which then triggers a key press on [the project’s] 
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Frazer 3D-printed 
the case for 
the electronics 


A Someone enjoying the calming sounds A The Makey Makey and Raspberry Pi 
triggered by the chimes are housed in a 3D-printed case at 


Frazer exhibited 


Vv 


Raspberry Pi. I programmed a patch in Scratch g hes so rewad rd l n g to see ie Biiinae at 
to play audio files when it receives these key Colchester Schaal 
presses, which you then hear over the headphones. people playing and smiling of Art 
There is no acoustic sound other than the dull ; ; ; 
clunk of stainless steel and copper pipes hitting with the chimes, cre ating > Alot of holes 
one another. However, in the headphones is ? needed to be 
an atmospheric soundscape of calming field th elf OWN SOUN d SCG e) eS 77 drilled in 
recordings and synthesizer drones.” the project! 

Frazer made the recordings using the Alchemy and smiling with the chimes, creating their own 
synthesizer in Logic Pro. “I used the amplitude soundscapes by activating them (some harder than = The Serato cca 

: : : i can be found at 

of a waterfall recording (which I made in the Isle others). My favourite comment was someone who man plee/ghpund 
of Mull) to affect different parameters of the called the work ‘curious’, as this summed up my 
synthesizer,” he says. “In Scratch, there’s avariable work so much better than I ever could.” > Frazer plans to 
counting every time the chimes ‘strike’ and when Frazer admits that it was a challenge to fit all switch from Scratch 
this is a modulus of 25, one of three large pulsating of the components inside the head unit of the to Pure Data for 
bass notes plays too, adding an element of surprise chimes, but “after cutting down a few cables and better audio quality 
to the installation and encouraging you to keep shuffling things around, I managed to fit it all in. 
playing and discovering more combinations of Thankfully the support system is designed so I can 


notes. Alongside this is a subtle field recording of easily adjust the hanging height from the beam 
the coastline from the same peaceful trip tothe Isle above, which is very useful when installing in 
d 


of Mull, completing the escapist soundscape.” ifferent venues.” 

It was also his first project with a Raspberry Pi, 
Heavenly harmonies which he used “because I wanted the chimes to be 
Sounds idyllic, and Frazer has clearly enjoyed unmanned and to be installed for long periods of 
seeing people explore the possibilities of the time, all without having to worry about securing a 
chimes: “It’s so rewarding to see people playing laptop somewhere behind the scenes.” Hi 
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Perfect option for your DYI or high-volume commercial projects 


Fits all kinds of HATs 
Ideal PoE HAT case 


Use with HAT or Pi alone 
Simple and professional 


Rapid, tool-free assembly 
GPIO cable pass-through 


Two wall mount options 
Well ventilated 


Designed and manufactured in North America 
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RASPBERRY py 


DIGITAL MEDIA HUB 


Build the ultimate 4K home theatre PC using 
g Raspberry Pi 4 and Kodi - By Wes Archer 


e love Raspberry Pi for how it’s helping a new 
W generation of children learn to code, how it’s 

resulted in an explosion of new makers of all ages, 
and how it’s really easy to turn any TV into a smart TV. 

While we always have a few Raspberry Pi computers at hand 
for making robots and cooking gadgets, or just simply coding a 
Scratch game, there’s always at least one in the house powering 
a TV. With the release of the super- powered Raspberry Pi 4, it’s 
time to fully upgrade our media centre to become a 4K-playing 
power house. 

We asked Wes Archer (@raspberrycoulis) to take us through 
setting one up. Grab a Raspberry Pi 4 and a micro-HDMI cable, 
and let’s get started. 
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Only Raspberry Pi 4 can output 
at 4K, so it's important to 
remember this when deciding Flirc Raspberry Pi 4 case 


on which Raspberry Pj to choose Made of aluminium and designed to be its own heatsink, 
the Flirc case for Raspberry Pi 4 is a perfect choice and 


looks great as part of any home media entertainment setup. 


z F This will look at home in any home entertainment system. 
aspberry Pi has been a perfect choice 


for a home media centre ever since 

it was released in 2012, due to it 
being inexpensive and supported by an 
active community. Now that 4K content is 
fast becoming the new standard for digital Official Raspberry Pi 4 
media, the demand for devices that support case (in black and grey) 
4K streaming is growing, and fortunately 
Raspberry Pi 4 can handle this with ease! 
There are three versions of Raspberry Pi 4, 
differentiated by the amount of RAM they > 
have: 1GB, 2GB, or 4GB. So, which one should is entertainment setup. If yow’re 
you go for? In our tests, all versions worked feeling adventurous, you can 


just fine, so go with the one you can afford. \ _—— alee haga caeata Held anal 
SK 4 
oe 


magpi.cc/NnDZiA 


The official Raspberry Pi 4 case is 
always a good choice, especially 
the black and grey edition as it 
blends in well within any home 


fan for extra cooling. 


magpi.cc/frppYm 


Aluminium Heatsink Case for 
Raspberry Pi 4 


It's possible to plug in an IR receiver and 
program Kodi so that you can use your 


TV remote to control your media centre, Another case made of aluminium, this >, 
but the Flirc USB IR receiver is perfectly is effectively a giant heatsink that helps » 
designed to do just that. Simply plug the keep your Raspberry Pi 4 cool when iil! 
USB receiver into a PC and follow a few in use. It has a choice of three Z 4 4 ill / 


quick steps to be up and running in no time. colours ~ black, gold, and gunmetal 
grey — so is a great option if you 
want something a little different. 


magpi.cc/knNohY 
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Get the 


right cables 


Raspberry Pi 4 uses a micro-HDMI 


> Maxtor 2TB external USB 3.0 HDD cud ie ff cable instead of the standard HDMI. 
4K content can be quite large and your storage Wa In fact, it uses two as you can 

will run out quickly if you have a large collection. y 4. output to two 4K displays at once. 
Having an external hard drive connected directly é J We recommend buying the newer 


to your Raspberry Pi using the faster USB 3.0 
connection will be extremely handy and avoids any 
streaming lag. 


micro-HDMI cables, but you can also 
use micro-HDMI to HDMI adapters if 
needed. If you do buy new cables, 
be sure they are micro-HDMI to 
HDMI, as most TVs will have the 
standard-sized HDMI inputs. 


magpi.cc/hyDQvY 2 


< Fan SHIM 


f The extra power Raspberry Pi 4 brings means things 
can get quite hot, especially when decoding 4K 
media files, so having a fan can really help keep 
things cool. Pimoroni’s Fan SHIM is ideal due to 

f its size and noise (no loud buzzing here). There is a 

» Af Python script available, but it also ‘just works’ with 
| sy” the power supplied by Raspberry Pi’s GPIO pins. 


. ie magpi.cc/qiYBWd 


> Raspberry Pi TV HAT 


If you are feeling adventurous, you can adda 
Raspberry Pi TV HAT to your 4K media centre to 
enable the DVR feature in Kodi to watch live TV. 
You may want to connect your main aerial for 
the best reception. This will add a perfect 
finishing touch to your 4K media centre. 


magpi.cc/imDdcw 


> Riii8+ Mini Wireless Keyboard 
If your TV does not support HDMI-CEC, allowing 


me 5 Pic = es you to use your TV remote to control Kodi, then 
A os 55 this nifty wireless keyboard is extremely helpful. 
ORS se Ppa Plug the USB dongle into your Raspberry Pi, turn 
- ge. Seis <o - on the keyboard, and that’s it. You now have a mini 
SASL keyboard and mouse to navigate with. 
<e3 e magpi.cc/ApxYux 
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LibreELEC is a lightweight OS 
designed to run Kodi, the home 
media centre software we'll be 
using in this guide 


Installation steps 


01 Download the LibreELEC USB-SD 
Creator app 

LibreELEC has a lovely app that makes it really 
simple to get up and running. Download the 
version for your OS (it supports Windows, Linux, 
and macOS) from magpi.cc/epmapU - or if you 
prefer, you can download the image for your 
chosen Raspberry Pi instead. 


02 Download the LibreELEC image 

Once downloaded, insert your microSD card 
into your computer and fire up the LibreELEC app 
you just downloaded. Select ‘Raspberry Pi 4’ from 
the version drop-down and then hit Download. 
Choose where to download the image file to and 
wait for the app to download the image. 


03 Create your microSD card 

Once your LibreELEC image has finished 
downloading, insert your microSD card into your 
computer, then select the drive from the drop- 
down menu. Lastly, hit Write and then wait for that 
to finish. Once done, you should have a working 
microSD card to use in your Raspberry Pi 4. 
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First-time setup steps 


¢ LibreELEC 


The first boot of LibreELEC 

Now you have your microSD card ready, connect the 
micro-HDMI cable to your Raspberry Pi 4 and TV and then 
hit the power. The first time LibreELEC boots, it will do some 
housekeeping, like checking the file system and expanding to fill 
your microSD card before rebooting automatically for the next step. 


Choose your language and get online 

LibreELEC will launch a welcome wizard to help get you 
started. You’ll need to pick your language, give your device a 
name (so it’s easy to find on your network), connect to WiFi, and 
configure SSH and/or Samba file sharing. You should be able to 
control this using your TV’s remote control without any setup if 
it supports HDMI-CEC. 


M The first time LibreELEC boots, it 
will do some housekeeping, like 
checking the file system @ 


Welcome to Kodi on LibreELEC! 

Once the wizard has been completed, you should be taken 
to the main home screen within Kodi. Congratulations! Right 
now, there’s not much to do other than familiarise yourself with 
the menus, maybe make some settings changes (e.g. change the 
location to the correct one for you), and explore. We’ll now show 
you how to add your media. 


Add media libraries 


01 Organise before you begin! 

Before you add your media to your new Raspberry Pi 4K media 
centre, a little organisation is recommended. This way, when you add the 
libraries to Kodi, scrapers (more on that later) will be able to download all 
the extra artwork to make your entertainment system look the business. 


«f KODI 
6 8 


Your library is currently empty. In order to populate it with your personal medi, « 


"Files" section, add a media source and configure it 
indexed you will be able to browse your library 


02 Add your media libraries 

A media centre is nothing without media, so we’ll need to add 
ours before we can play them on our Raspberry Pi. Kodi makes this really 
simple, so navigate to Videos in the menu, select Files, and finally ‘Add 
videos’. You’ll now be able to use the Browse option to locate your media 
files, depending where they are stored. 


Explore 


the settings 


cancel in Kodi to 


really get the 
most out 
of it 


03 Give your libraries names 

You can group your libraries, and typically Kodi uses Movies, TV, 
Music, and Photos. By adding your media into groups, Kodi will treat them 
accordingly so you can browse and watch very easily from the navigation 
menu. It is even possible to combine multiple sources (e.g. from a NAS and 
a USB HDD) for convenience. 


Magri 


Organising media 
and scraping info 


Using scrapers to add artwork 

Scrapers are essentially scripts within 
Kodi that can search online databases to pull 
information about each media file you have, 
and download the corresponding artwork, such 
as movie poster, disc art, cases, and wallpapers 
(aka fan art). Assuming your libraries are 
organised as per our steps earlier, this should 
be straightforward. 


Set the content type when 
adding media 
When adding media, you should be asked what 
the directory contains (it defaults to ‘None’). 
If you pick Movies from the options, this 
tells Kodi to use the appropriate information 
provider (i.e. The Movie Database) to scrape 
and download the resulting information and 
artwork when scanning the library. 


Let the scraping begin! 

Once you have set the content and 
chosen the information provider, hit OK and 
then you’1l be asked if you want to refresh 
information for all items — hitting Yes will start 
the scraping, and you’ll soon have detailed 
information about each movie, including any 
artwork too. 
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Now that the basics have been 
mastered in our Raspberry Pi 
AK media centre, why not try 


something a little more advanced? 


network-attached storage device 

(NAS for short) is a hard drive 

(or drives!), usually served by a 
lightweight operating system, that is 
attached to a network. The beauty is that 
you can share files across your network so 
that other network attached devices (such as 
our media centre) can access them. 


Using your phone 


as the remote 


Kodi has an official 


app available (iOS: : oc 
magpi.cc/LbeLuJp, a a | 
Android: n a~ : 
magpi.cc/RBNgRy) rs 

<"@ 
that allows you to 4 ee > 
control your media 
centre directly > i a 
from your phone. £ 2 @ 4 


Download the app to 

your phone, then hit 

‘Add host' to pair it with your Raspberry Pi. 
You can manually enter your Raspberry Pi's 
IP address, or hit ‘Find Kodi’ which should 
automatically find it for you. Once paired, 
you can use the app to navigate around 
Kodi like a regular remote. 
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Add network storage 


System 
Network 


Connections 


Bluctooth 


About 


DS ivretvec 


Ensure SMB has been enabled in Kodi 
Remember at the welcome wizard when you were asked 
about SSH and Samba? Well, Samba is not just a Brazilian dance, 
but a form of file sharing too! If you did not enable Samba 
(abbreviated to SMB), then you can do so in System > 
LibreELEC > Services. 


Add your network shared media 

This process is very similar as before. Go to Videos > 
Files > Add videos, then hit Browse. This time, select ‘Windows 
network (SMB)’ and then you should see your shared files 
appear. This assumes you have already configured SMB on your 
NAS; you may be prompted to enter a username and password 
if required. 


Set the content for your libraries 

Again, be sure to pick the content type for your network 
shared files. Kodi will add the files to the appropriate place in the 
navigation menus accordingly. Sharing files over the network can 
cause some buffering, depending on how fast and reliable your 
home network is, so just keep this in mind. 


. 
. 
2 


4 Update and clean your library 
automatically 


If you regularly add and remove content to and 
from your libraries, you will want to ensure that 
Kodi updates the actual libraries too. Enable 

the ‘Update library on startup’ option to ensure 
that your new files are added automatically. It is 
also worth ‘cleaning’ your library too, in order 
to remove deleted files. 


Set the region to your own 


By default, Kodi favours the US audience, 

so if you are one of our US readers then this 
probably won’t apply to you! However, the 
regional settings — such as the date, time, 

and temperature format - can be changed to 
match your own. Head to Settings > Interface > 
Regional and set it to your liking. 
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Change the look and feel of Kodi 


There’s nothing wrong with the default Kodi 
skin (Estuary), but there are a number of 
different ones to install and try out. Head over 
to Settings > Interface, then you can change 
the skin, or ‘Get more’ with a few clicks. Our 
personal favourite is Aeon Nox: SiLVO because 
there are so many customisations available. 


4 Enhance the information Kodi sees 


Media files often have additional ‘tags’ that 
contain extra information about the file itself, 
which can be quite useful when you have a 
large collection. Going into Settings > Media > 
Videos and turning on ‘Use video tags’ enables 
this. Whilst you’re there, ensure the three 
‘Extract...’ options are on too, in order to 
enhance your experience. 


An alternative 
for Android 


Android users 

can also use the 

Official Kodi Remote app, called 
Kore, available in the Play Store. 


users, Yatse has 

fantastic reviews 

and also has support for Plex and 
Emby servers. 


Available on the 

App Store for 

iOS, the Official Kodi Remote is a 
sturdy choice for Apple users. 
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Evans 


PJ is a writer, 
developer, and 
Milton Keynes 
Raspberry Jam 
wrangler. Unlike 
a cluster, he can 
only do one thing 
at a time. 


@mrpjevans 


[ You'll Need 


» 4 Raspberry 
Pi 4 computers 
magpi.cc/rpi4 


» Cluster case 
magpi.cc/XtUbVm 


» Ethernet switch 
magpi.cc/fzcGEA 


» Multi-port USB PSU 
magpi.cc/AekkAr 


» 4x USB C cables 
magpi.cc/UcmFAM 


> 4x Ethernet cables 
magpi.cc/LsAnrA 


Build a Raspberry 
Pi cluster computer 


Think Raspberry Pi computers are no match for their bigger cousins? 
Think again, because there's strength in numbers 


and cheerful. Great for playing around 
with and the odd little project, right? 
Well, sometimes. 

However, our little friend is a surprisingly 
powerful computer and when you get lots of them 
working together, amazing things can happen. 

The concept of computer ‘clusters’ (many 
computers working together as one) is nothing 
new, but when you have a device as affordable as 
Raspberry Pi, you can start to rival much more 
expensive systems by using several in parallel. 
Here, we’ll learn how to make a cluster computer 
from a lot of little computers. 


2 aspberry Pi computers are famously cheap 


Cluster assemble! 

A cluster of Raspberry Pi computers can 
start with as little as two and grow into hundreds. 
For our project, we’re starting with a modest four. 
Each one, known as a ‘node’, will carry out part 


A Adedicated inexpensive switch will speed up 
communications. Raspberry Pi 4 computers can take 
advantage of full-bandwidth Gigabit Ethernet 
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of our task for us and they all work in parallel to 
produce the result a lot quicker than a single node 
ever could. Some nice ‘cluster cases’ are available, 
and we start here by assembling our Raspberry 

Pi 4B computers into a four-berth chassis. Many 
different configurations are available, including 
fan cooling. 


Power up 

Consider the power requirements for your 
cluster. With our four nodes it’s not going to be 
ideal to have four PSUs driving them. As well as 
being ugly, it’s inefficient. Instead, track downa 
good-quality, powerful multi-port USB charger 
that is capable of powering your chosen number of 
computers. Then all you need are the cables to link 
them and you’re using a single mains socket. USB 
units are available that can handle eight Raspberry 
Pi computers without breaking a sweat. Do be 
careful of the higher demands of Raspberry Pi 4. 


Get talking 

A cluster works by communication. A 
‘master’ node is in charge of the cluster and the 
‘workers’ are told what to do and to report back 
the results on demand. To achieve this we’re using 
wired Ethernet on a dedicated network. It’s not 
essential to do it this way, but for data-intensive 
applications it’s advisable for the cluster to have its 
own private link-up so it can exchange instructions 
without being hampered by wireless LAN or other 
network traffic. So, in addition to wireless LAN, 
we’re linking each node to an isolated Gigabit 
Ethernet switch. 


Cluster cases like this one 
are cheap and available ina 
wide range of configurations 


Raspbian ripple 

We’re going to access each node using 
wireless LAN so the Ethernet port is available 
for cluster work. For each ‘node’, burn Raspbian 
Buster Lite (magpi.cc/raspbian) to a microSD 
card, boot it up, and make sure it’s up to date with 
sudo apt -y update && sudo apt -y upgrade. 
Then run sudo raspi-config and perform the 
following steps: 


e Change the ‘pi’ user password. 
e Under ‘Networking’, change the hostname 
to nodeX, replacing X with a unique number 
(node1, node2 etc.). Node1 will be our ‘master’. 
e Enable WiFi if desired. 
Exit and reboot when prompted. 


Get a backbone 

The wired Ethernet link is known as the 
cluster’s ‘backbone’. You need to manually enable 
the backbone, as there is no DHCP server to help. 
We're going to use the 10.0.0.0 subnet. If your 
regular network uses this, choose something 
different like 192.168.10.0. For each node, from the 
command line, edit the network configuration: 


sudo nano /etc/dhcpcd. conf 
Go to the end of file and add the following: 


interface etho 
static ip_address=10.0.0.1/24 


For each node, replace the last digit of ?10.0.0.1 
with a new unique value: 10.0.0.2, 10.0.0.3, and so 
on. Reboot each node as you go. You should be able 
to ping each node - for example, from 10.0.0.1: 


ping 10.0.0.2 


DS 


Brand new key 

For the cluster to work, each worker node 
needs to be able to talk to the master node without 
needing a password to log in. To do this, we use SSH 
keys. This can be a little laborious, but only needs to 
be done once. On each node, run the following: 


ssh-keygen -t rsa 


This creates a unique digital ‘identity’ (and key 
pairs) for the computer. You’ll be asked a few 


Use fast wired Ethernet 
as the communications 
backbone 


Load balancing 


Clusters are 

also useful for 
acting as a single 
web server and 
sharing traffic, 
such as Mythic 
Beast's Raspberry 
Pi web servers. 
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- questions; just press RETURN for each one and do 

Top TI p a not create a passphrase when asked. Next, tell the 
master (node1, 10.0.0.1 in our setup) about the keys 

Fault tolerance by running the following on every other node: 


Certain cluster ssh-copy-id 10.0.0.1 
types, such as 


Dees vainver Finally, do the same on the master node (node1, 
Kubernetes, allow 


individual‘nodes 10.0.0.1) and copy its key to every other node in 


to fail without the cluster. 
disrupting service. 


07 Install MPI 
The magic that makes our cluster work is 

MPI (Message Passing Interface). This protocol 
allows multiple computers to delegate tasks 
amongst themselves and respond with results. 
We’1l install MPI on each node of our cluster and, 
at the same time, install the Python bindings that 
allow us to take advantage of its magical powers. 
On each node, run the following: 


sudo apt install mpich python3-mpi4py 
Once complete, test MPI is working on each node: 


mpiexec -n 1 hostname 


You should just get the name of the node echoed back 
at you. The -n means ‘how many nodes to run this 
on’. If you say one, it’s always the local machine. 


A Instead of a row of wall-warts, use a multi-port USB charger to power your cluster nodes, 
but make sure your choice of unit has enough amps 


42 | magpicc | Build a Raspberry Pi cluster computer 


Let’s get together 
Time for our first cluster operation. From 
node (10.0.0.1), issue the following command: 


mpiexec -n 4 --hosts 10.0.0.1,10.0.0.2,10.0. 
@.2,10.0.0.4 hostname 


We're asking the master supervisor process, 
mpiexec, to start four processes (-n 4), one on each 
host. If you’re not using four hosts, or are using 
different IP addresses, you’ll need to change this 
as needed. The command hostname just echoes the 
node’s name, so if all is well, you’ ll get a list of the 
four members of the cluster. You’ve just done a bit 
of parallel computing! 


™ Now we've confirmed the 
cluster is operational, let's 
put it to work @ 


Is a cluster of one still a cluster? 

Now we’ve confirmed the cluster is 
operational, let’s put it to work. The prime.py 
program is a simple script that identifies prime 
numbers. Enter the code shown in the listing 
(or download from magpi.cc/EWASJx) and save 
it on node1 (10.0.0.1). The code takes a single 
argument, the maximum number to reach before 
stopping, and will return how many prime 
numbers were identified during the run. Start by 
testing it on the master node: 


mpiexec -n 1 python3 prime.py 1000 


Translation: ‘Run a single instance on the local 
node that runs prime.py testing for prime 
numbers up to 1000.’ 

This should run pretty quickly, probably well 
under a second, and find 168 primes. 


Multiplicity 

In order for the cluster to work, each node 
needs to have an identical copy of the script we 
need to run, and in the same place. So, copy the 
same script to each node. Assuming the file is in 
your home directory, the quick way to do this is 
(from node1): 


scp ~/prime.py 10.0.0.x: 


Master 


A Our cluster works by assigning a master node. The master 
assigns tasks to its member nodes and waits for them 
to report their results. 
Credit: Raspberry Pi illustrations by Jonathan Rutheiser 


Replace x with the number of the node required: 
scp (secure copy) will copy the script to each node. 
You can check this has worked by going to each 
node and running the same command we did on 
node1. Once you are finished, we are ready to start 
some real cluster computing. 


Compute! 
To start the supercomputer, run this 
command from the master (node1): 


mpiexec -n 4 --host 10.0.0.1,10.0.0.2,10.0.0 
-3,10.0.0.4 python3 prime.py 100000 


Each node gets a ‘rank’: a unique ID. The master 
is always 0. This is used in the script to allocate 
which range of numbers each node processes, so 
no node checks the same number for ‘primeness’. 
When complete, each node reports back to the 
master detailing the primes found. This is known 
as ‘gathering’. Once complete, the master pulls all 
the data together and reports the result. In more 
advanced applications, different data sets can be 
allocated to the nodes by the master (‘scattering’). 


Final scores 

You may have noticed we asked for all the 
primes up to 1000 in the previous example. This 
isn’t a great test as it is so quick to complete. 
100,000 takes a little longer. In our tests, we saw 
that a single node took 238.35 seconds, but a four- 
node cluster managed it in 49.58 seconds — nearly 
five times faster! 

Cluster computing isn’t just about crunching 

numbers. Fault-tolerance and load-balancing are 
other concepts well worth investigating. Some 
cluster types act as single web servers and keep 
working, even if you unplug all the Raspberry Pi 
computers in the cluster bar one. {il 
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ee1. 
0e2. 
0e3. 
004. 
ee5. 
eQe6. 
00e7. 
e008. 
ee9. 
e108. 
e111. 
Q12. 
013. 
14. 
15. 
16. 
Q17. 
18. 
Q19. 
Q2e. 
e21. 
Q22. 
Q23. 
e24. 
25. 
Q26. 
Q27. 
28. 
Q29. 
030. 
Q31. 
Q32. 


Q33. 
034. 
Q35. 
Q36. 
037. 
038. 
Q39. 
04e. 


e041. 


042. 
043. 
e044. 
45. 
e046. 
047. 
e048. 
49. 
eQ5e. 
Q51. 
Q52. 
Q53. 
eQ54. 
Q@55. 
Q56. 
Q57. 
e58. 
Q@59. 
e608. 
Q61. 
062. 


from mpi4py import MPI 
import time 
import sys 


# Attach to the cluster and find out who I am and how big it is 
comm = MPI.COMM_WORLD 

my_rank = comm.Get_rank() 

cluster_size = comm.Get_size() 


# Number to start on, based on the node's rank 
start_number = (my_rank * 2) + 1 


# When to stop. Play around with this value! 
end_number = int(sys.argv[1]) 


# Make a note of the start time 
start = time.time() 


# List of discovered primes for this node 
primes = [] 


# Loop through the numbers using rank number to divide the work 
for candidate_number in range(start_number, 
end_number, cluster_size * 2): 


# Log progress in steps 
# print(candidate_number) 


# Assume this number is prime 
found_prime = True 


# Go through all previous numbers and see if any divide without 
remainder 
for div_number in range(2, candidate_number): 
if candidate_number % div_number == 
found_prime = False 
break 


# If we get here, nothing divided, so it's a prime number 
if found_prime: 
# Uncomment the next line to see the primes as they are found 
(slower) 
# print('Node ' + str(my_rank) + ' found ' 
number) ) 
primes .append(candidate_number) 


+ str(candidate_ 


# Once complete, send results to the governing node 
results = comm.gather(primes, root=0) 


# If I am the governing node, show the results 
if my_rank == 


# How long did it take? 

end = round(time.time() - start, 2) 
print('Find all primes up to: ' + str(end_number)) 
print('Nodes: ' + str(cluster_size)) 
print('Time elasped: ' + str(end) + 


seconds’) 


# Each process returned an array, so lets merge them 
merged_primes = [item for sublist in results for item in sublist] 
merged_primes.sort() 

print('Primes discovered: ' + str(len(merged_primes))) 

# Uncomment the next line to see all the prime numbers 

# print(merged_primes) 
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Danny makes 
robots with his kids 
as Orionrobots 

on YouTube, and 

is the author of 
Learn Robotics 
Programming. 


orionrobots.co.uk 


[ You'll Need 


>» 2x Obstacle 
avoidance modules 
magpi.cc/paTuQW 


Mini breadboard 
magpi.cc/CuBDyB 


v 


v 


2 x TCRT5000 
sensor modules 
magpi.cc/TtfhiF 


» Jumper wires 


magpi.cc/pPnpZL 


Plastic standoffs 
and screws 
magpi.cc/Cixtpr 


v 


v 


5mm pitch 
terminal block 
magpi.cc/jeThnM 


v 


Black insulating 
tape 


v 


Plain white paper 


Add sensors to 
a low-cost robot 


Make a robot react to the world with sensors. Fascinating 
behaviours emerge with only a bit of code and electronics! 


low-cost wheeled robot. Without any 
sensors, it doesn’t respond to the world and 
drives into walls. 

The robot’s Raspberry Pi has many GPIO pins 
left to add inexpensive sensors for it to interact 
with its surroundings. This tutorial shows how to 
use a couple of similar sensor types, put them in 
useful places, wire them in, and write the code. 
We’ll touch on the trade-offs and limitations, 
learn how to calibrate the sensors, and make test 
tracks for line following. 


0 ver the last few issues we’ve built a 


Meet the sensors 

The two types of sensor in this tutorial 
both detect reflected infrared light (IR). 
Obstacle sensors detect objects close enough 
by a brightness level. Line sensors detect how 
light/dark the floor is below them. 


A The robot with sensors part-fitted. See how the cables go 
through a port in front of the batteries 
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[he sensor models chosen are cheap and easily 
found online, but being IR sensors, they can be 
dazzled and confused by bright sunlight and some 
fluorescent lights. 

These sensors output digital (on/off) signals, with 
a dial adjusting the level to go from off to on. They 
come on carrier boards as 3.3 V compatible modules, 
making them easier to connect to Raspberry Pi. 


How to use sensors 

Obstacle sensors should be front-most, 
so they don’t detect the robot itself. By using two 
sensors facing forward and slightly to either side, 
a robot can decide which way it needs to turn to 
avoid an obstacle. 

Line sensors should be under the robot to detect 

if it has gone off track. A single sensor could sweep 
across and back over a line, but two sensors, wide 
enough to go either side of a line, make for a 
smoother system. They can sense when the line is 
not in the middle, and which way the robot needs 
to turn to correct it. 


Planning and sketching 
Test-fit the obstacle sensors on the top of 
the robot, facing forward and slightly outward. 
Sketch the top of the robot showing where to 
attach the sensors (Figure 1). 2.5mm bolts work 
for this. Adda 10mm hole for wires to go through, 
clear of other features. 
Next, test-fit line sensors under the robot, 
sticking out of the front and about 5 to 7cm apart. 
Finally, sketch the bottom of the robot with line 
sensors and another wire hole. You may be able to 
use the threads from the standoffs for Raspberry 
Pi to hold the line sensors if they are long enough. 


A The components needed include terminal blocks on a 
breadboard, obstacle sensors, line sensors, and jumper wires 


Drilling holes 

Take off the top of the robot, disconnecting 
the power wires from the motor controller. Use 
safety gear for all drilling. 

Depending on the line sensor placement, you 
may need to detach the robot’s Raspberry Pi and 
castor before drilling holes in the base of the robot. 

Using your sketches, measure out and drill the 
holes for the sensors. For the cable holes, drill small 
holes and enlarge them. Remove any excess plastic. 
Replace your Raspberry Pi and castor, but don’t bolt 
the sensors in or reconnect the batteries just yet. 


Power distribution 

The breadboard gives the sensors access 
to power rails. 5mm terminal blocks fit into the 
breadboard, simplifying connecting the batteries 
and UBEC. Slot two of the blocks together to make 
a block of four and pop it into the breadboard, as 
shown in Figure 2 (overleaf). 

Add breadboard internal wiring connections — 
pre-cut jumper wires do a tidy job of this. Popping 
the breadboard lightly into the robot, make the 
connections to Raspberry Pi3.3V and motor board. 

The jumper coming from the battery red 
(positive) wire on the breadboard is a suitable place 
for an optional power switch. 


Wiring the sensors 

Push a four-way male-female jumper wire 
through each cable port on the top and bottom for 
power connections. Use these to wire the sensor 
VCC/V+ pins to the 3.3 V breadboard row and the 
GND/G pins to the ground row. 
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Obstacle sensors 
bounce infrared light off 


Infrared line sensors 
detect floor reflectivity 
to track and follow lines 


objects to detect them 
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™5mm terminal blocks fit into the 
breadboard, simplifying connecting the 
batteries and UBEC © 
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Wear goggles 


Please use safety 
goggles and a desk 
clamp for drilling. 


A Figure 1A start ona sketch of the top and the sensor dimensions 
Be prepared to sketch a couple of times, adding more features 


Add sensors to a low-cost robot | magpicc | 45 


WE Magri | TUTORIAL 


Light Level 


A As the light detected 
goes up and crosses 
a threshold set by 
the dial, the sensor 
will output a logic 1 
Below this it's 0 


obstacle_avoid.py 


Threshold, 
set by dial 


Above Threshold 


Value: 1, On, True 


Below Threshold 


Value: 0, Off, False 


Sensor digital output pins are labelled Do, 
DOUT, or S. Wire this pin to a free GPIO pin with 
a female-female jumper wire. The code uses pins 
5 and 6 for the line sensors facing the floor and 
pins 13 and 26 for the obstacle sensors. Mount the 
sensors, reassemble the robot, and turn it on. 


07 Calibrating the sensors 

The sensors may have two LEDs: one is for 
power and always on, and the other for sensing. Take 
the robot out of direct sunlight. Ensure nothing is in 
front of the sensors for a couple of metres. 

The sensors have a screwdriver dial on them 

to adjust the light level they switch on at, which 
translates to the distance. 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


ee1. 
002. 
003. 
e004. 
005. 
006. 
007. 
008. 
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10. 
011. 
Q12. 
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14. 
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from signal import pause 

import atexit 

import gpiozero 

from gpiozero.tools import scaled, negated 


robot = gpiozero.Robot(left=(27, 17), right=(24, 23)) 
left_obstacle_sensor = gpiozero.DigitalInputDevice(13) 
right_obstacle_sensor = gpiozero.DigitalInputDevice(26) 
# Ensure it will stop 

atexit.register(robot.stop) 


robot.right_motor.source = scaled( 
left_obstacle_sensor, -1, 1) 
robot.left_motor.source = scaled( 
right_obstacle_sensor, -1, 1) 


pause() 
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A Figure 2 The power board wiring prepares a power rail for 
3.3V and a rail for GND to connect the sensors to 


Put a reflective obstacle about 10cm in front of 
a sensor. Turn the dial slowly to a point the LED 
turns off. Turn it a tiny way back and it should be 
on. Wave the obstacle back and forth and watch the 
LED changing. 


Sensors in GPIO Zero 
GPIO Zero sensors have a value for code to 
read their state, which a loop could use to set motor 
values. However, there is a different way to use it. 
GPIO Zero has a smart source/value system. A 
sensor input device can be a ‘source’ for an output 
device like a motor, sending a continuous stream 
of data. So sensor inputs can be virtually wired to 
affect output, eliminating the loop. 
The source/value system has tools to manipulate 
the data like scaling, negating, or delaying it. 
Mathematical functions like a sine wave can also 
be sources. See magpi.cc/hPmwrv for more ways 
to use this. 


mA sensor input device 
can be a ‘source’ for an 
output device like a motor, 
sending continuous data @ 


Driving with sensors 

The obstacle_avoid.py code makes a 
DigitalInputDevice for each sensor. 
Line 10 registers motor.stop with the ‘atexit’ 
system, guaranteeing when the code stops, for any 
reason, the motors stop too. 
Lines 12 and 13 wire the sensors to the opposite 
motors, so the robot will turn away from any 
detected object. 

The code scales the sensor values 0 (obstacle 

detected) and 1 (clear) into motor speed values of 
-1 (reverse) and 1 (go forward). 


STRATO PI CM DUO 


Dual SD card: for the first time on an industrial Raspberry Pi CM based device! 


Strato Pi CM Duo is the perfect solution for high-reliability systems - featuring two distinct SD cards with 
high-speed switching matrix for separate OS/data storage, redundancy and in-field full-system upgrades. 


Fault tolerance is further enhanced by: 

- Regulated wide-range power supply 

- Hardware watchdog with boot SD switch control 
- Power-controlled USB ports 


Additional features: 

- Opto-isolated RS-485 serial interface 

- Real-Time Clock with a replaceable backup battery 
- Secure element 


All of this in a compact DIN-rail case! 
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A For testing line 
sensors, a track 
is essential. This 
layout's simple, 
but it's fun to get 
more creative 


4 The full wiring 
diagram for the 
robot, sensors, 
and power 
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follow_line.py 


» Language: Python 3 
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003. 
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11. 
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13. 


14. 
Q15. 


from signal import pause 

import atexit 

import gpiozero 

from gpiozero.tools import scaled, negated 


robot = gpiozero.Robot(left=(27, 17), right=(24, 23)) 
left_line_sensor = gpiozero.LineSensor(5) 
right_line_sensor = gpiozero.LineSensor(6) 

# Ensure it will stop 

atexit.register(robot.stop) 


robot.left_motor.source = scaled(negated(left_line_ 
sensor), -@.3, 0.4) 

robot.right_motor.source = scaled(negated(right_line_ 
sensor), -0.3, 0.4) 


pause() 
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Run this to see the robot avoid walls and 
obstacles. The sensors miss obstacles above or 
below their fields of view, or those too dark and 
matte to reflect light. 


Line following 

Using sheets of plain white paper (A4 to A1) 
and black tape (about 20 mm wide), make a single 
line along the middle of a sheet. 

Create a small calibration square of about 
4omm, and put a strip of tape across one end. 

Make some curved sections on other paper 
sheets; keep the turns to less than 45 degrees, and 
the lines no closer than a robot width apart. 

The robot drives forward until the sensor 
encounters a line. You can use this to make a 
crossing, by leading tracks to a gap from both 
horizontal and vertical directions 


Calibrating line following 

Calibrate the line sensors in a similar way to 
the obstacle sensors. It may be easier to detach the 
sensor for calibration and reattach it afterwards 
depending on where the dial is. 

Using the calibration square, hold a white area 
about 2cm from a line sensor. Slowly turn the 
sensor dial until the LED changes - wave the 
paper between black and white to observe the LED 
changing, and adjust if needed. 

You’ ll need to recalibrate for different lighting or 
surface conditions. 


Line following code 
The follow_line.py code is similar to 
obstacle avoiding. 

Lines 7 and 8 set up GPIO Zero line sensors 
(based on digital input) on the correct pins. 

The line sensors straddle the track. When the 
sensor detects white (sending 0), it’s not crossing 
the line and so the motor goes forward. 

Lines 12 and 13 connect the sensor output so a 
motor reverses when its sensor crossed the line 
onto black tape (sending 1). The input source is 
negated to make o the move forward condition. 

So that the robot responds to the track before 
driving past it, scale the source data to go from 
-0.3 to 0.4. 
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Hack GraviTrax _ 
with Raspberry P1 


Make spectacular marble runs by triggering 
sounds and animations from a Raspberry Pi 


raviTrax is a construction system to make Do not discard these hexagons, because we are 
your own marble runs of any complexity. going to use them in our project. If you have 
From the famous toy maker Ravensburger, already discarded them, then you’!l need to cut 
it is aimed at the STEM market as well as kids of all out a hexagon from either cardboard of the same 
ages. It has lots of extension packs for more basic thickness or 3mm plywood. We made two types of 
parts and new fun features. There is only one thing sensor: a Standalone one, and ones where you have 
Veteran magazine missing, until now: an interface to Raspberry Pi. to modify an existing part. Just like the GraviTrax 
ne ae We have always wanted to do a marble run system, our approach is modular and you can make 
Body Build series, project, so when we saw the GraviTrax system we as many of each sensor type as you like. 
plus co-author of were excited because it had all the ingredients we 
Raspberry P) FOr needed. Also, it is built up on a grid of hexagon 
Dummies, Raspberry 7 es 
Pi Projects, and spacing, and we are suckers for hexagons. The 
Raspberry jPi standardised parts, and wide availability, meant we How do they work? 
Projects for could make our own parts, or modify existing parts, All the sensors in this part use light to detect 
nee to feed back events into the Raspberry Pi and have the presence of a ball - through breaking a beam, 
magpi.cc/TPaUfT —_ them trigger sounds or animations. We can also detecting reflected light, or simply the presence 
trigger lights to make our run more exciting. In this or absence of ambient light. As such, the circuits 
first part, we will concentrate on detecting the balls. are all very similar as shown in Figure 1; the only 
difference is the physical sensor used, and the 
current limiting resistor value on the LED. They are 
connected to the Raspberry Pi by a length of three- 
The GraviTrax system wires-wide ribbon cable, with a pull-up resistor 
When you get your starter set, you have going on the board that connects to the GPIO pins. 
¥ hk platen es to prepare the cardboard base by pushing out In later parts of this tutorial series, we will look at 
optical sensors hexagons to leave holes to mount the tiles in. making a distribution board for them all. 
Long wire run Figure 1 Figure 2 
Raspberry Pi q 5V 
GPIO pin 3V3 i ' i Signal 
3V3 ia Gnd 
TE 1 
— 5K6 i 
Sensor Connector ' ' 
GPIO pin Signal 5V 
Gnd Lt | Signal 
nee im Gnd 
OPB706b SX1140 OPB 704 TCRT1010 
Dot on other side R limit ce ka 
R limit R limit 
82R —_# ees R limit 51R O : 
k 2 ¢@ c 41R 
a © ¢ e O ‘ 
: A Figure 2 Physical layout of 
Back View k the optical slot sensor 
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An optical 
slot sensor 


Figure 3 The optical slot sensor in action 


Wooden arm 


66.00 


13.00) 


650 | | 


OPB 704 
ce ka 


Signal 


Front of sensor 
3V3 Gnd 


Wiring from the back of the sensor 


3.0 hole —— | 


Aluminium bracket 


4.0 


-- 
| — 50 


4 


3.0 


13.0 


(| Figure 4 The plans 


or the reflective 
detector 


=e 


/ A track monitor \ 
4 3 f -. y > 


Optical slot sensor 
The first sensor we will look at is an optical 

slot sensor. This fits under a track and the height 

can be adjusted by using the small or large height 

tiles. Basically, this is a cardboard hexagon with 

a small piece of 3mm plywood stuck on it and 

he electronics glued to that, going from point 

0 Opposite point on the hexagon. The physical 

construction of the electronics board is shown 

in Figure 2, with the whole assembly shown in 

Figure 3. It is best to glue the electronics in place 

with a track running through it, between two 

pieces, so you can get it aligned precisely. 


t 
t 


Reflective detector 

The previous sensor needs to be placed 
under a track, whereas this one can be placed in 
an adjacent space and it looks downwards. It is 
capable of detecting balls on the entrance or exit 
to any of the tiles, be it basic, curved, or launch 
pad. The sensor is easy to make, as the LED and 
transistor symbols are drawn on the part. We used 
a Stack of five cardboard hexagons glued together, 
followed by a plywood hexagon with a hole in the 


centre and a10mm, M3 countersunk screw sticking 


through it. This was then placed on the arm, and 
could be rotated to the required point. 


Hack GraviTrax with Raspberry Pi 


Top Tip 


GraviTrax 
simulator 


You can geta 
free GraviTrax 
simulator to run 
on your mobile 
device. You can 
make layouts and 
see the results 
with a variety of 
effects, even from 
a ‘balls eye’ view 
of the run. 


You'll Need 


> GraviTrax - 


Starter set 
magpi.cc/LusGgA 


» ESSX1140 opto slot 


magpi.cc/nQNQNW 


> OPB704 Reflective 


opto sensor 
magpi.cc/fwUrdD 
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TopTip & 


Track monitor 


When gluing the 
PCB to the track, 
glue the long 
edge first, then 
push the sensor 
slightly so it is 
not parallel to the 
track, and test 
that it detects the 
ball before gluing 
the sides to hold it 
into position. 


P Figure 5 The 
reflective detector 
in action 


akeoc 


Making the reflective detector 

Figure 4 shows the measurements of the 
plywood arm, and the mounting bracket made 
from a piece of 12x12mm angle aluminium. The 
arm should be notched with the corner of a square 
file; this is so a cable tie can grip the ribbon cable 
without slipping. The height of the sensor is 
adjustable due to a long slot in it, allowing it to be 
slid up and down. You need a gap of about 2mm 
between the sensor and the top of a ball to detect 
it reliably (Figure 5). You can mount two arms ona 
stack to get coverage of another position. 


A track monitor 

The last two sensors have been standalone, 
the next one modifies a GraviTrax part. The 
physical layout is shown in Figure 6. The TCRT1010 


ce ka 


5V Gnd _ Signal 


TCRT1010 


A Figure 6 Physical layout 
of a track monitor 
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sensor comes with bent leads which neatly wrap 
round two holes of stripboard. On the strip side, 
you need to bend the connectors over again and 

cut them short. Then bend the middle two so they 
sit on one track and solder them up. You also need 
a surface-mount 51Q resistor to make it small, 
although a 025 W through-hole resistor could be 
used. The assembly needs hot-melt gluing onto the 
track (Figure 7). 


07 Launch pad monitor 

Take an OPB706B sensor and wrap it round 
the centre post in the launch pad tile (Figure 8). 
Push it down and use a pencil to mark the outline 
on the wall. Then, using a Dremel, and 1mm router 
bit, cut to about 1mm short of the outline you 
drew, so the part does not go through the hole. 
Also, cut a slot in the opposite side to let the wires 
through when attached to a height tile. Paint 
black the area the sensor is pointing at, and glue a 
10x2mm piece of 1mm thick styrene to the green 
plunger with polystyrene glue (Figure 9). 


Switch monitor 

This uses ambient light to detect which 
way the switch is set. Draw in pencil around the 
switching lever in both positions, showing the area 
being covered and uncovered. Then drill a 2mm hole 
in the middle of this area (Figure 10). Next, paint 
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A Figure 9 The finished 
launch pad monitor 
V Figure 10 Drilling the 
fi hole for the 
I 3 switch monitor 
ad 


onm Figure 10 
= 


i» 


A Figure 7 The track monitor in action 


A Figure 8 Marking the hole outline on the launch pad 2? a 


the underside of the switch tile black, and make 


sure you paint on the inside of the hole (Figure 11). 


The schematic of this sensor is somewhat different . Dent 


from the others and is shown in Figure 12. Finally, ~— a 
Figure 13 shows the physical layout of the parts. IGUIE 
Position the board so you can see the white sensor — Baad 
through the hole and fix with Sugru. Figure 12 Raspberry Pi bats es rire 
r— 3Vv3 tile black 
™ The GPIO pins are scanned ; 4. Figure 12 Schematic 
| 5K6 of the switch monitor 
and when a trigger 1 
ae : SS a ——— GPIO 
condition is met @ Sx / 
SFH3410 it 
5 a a Ground 
Software SFH3410 | 
We have written software, shown in the Collector [| @ Not connected Long sien 
Emitter 


sound_trigger.py listing, that monitors these 
sensors, and triggers sounds, either immediately ra 

or after a delay. The software is modular: line tae 

82 determines what GPIO pins you will use and 2N2222 or general purpose NPN 
it automatically generates a window size to 


accommodate the number of pins in this list. Note 


Cc 
=a 


if you want to use GPIO 14, you should disable Figure 13 1.6mm Audio cable 


SFH3410 


SPI before booting with the sensor attached. The 
sounds’ names are in a list at line 88; by simply 
changing or adding to this list, different sounds 
can be used. The GPIO pins are scanned and when 
a trigger condition is met, the event is put ina layout of the 
pending list to be actioned at the correct time. Cut track Gnd switch monitor 


Signal 


Figure 13 Physical 
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A Figure 14 The software user interface 


Using the software 

The user interface is shown in Figure 14. 
For each line, you can set what the trigger action 
will be. These states are: disabled, when the signal 
goes high, when it goes low, or when it goes either 
high or low. They are changed by clicking on the 
trigger icon. The delay column, as you might 
expect, determines a delay between the trigger 
and the sound, whereas the sound sample played 
can be changed by the icons on the right. You can 
change the GPIO pin and note that one pin can 
trigger different actions; so, for example, you could 
have the switch tile generating a different sound 
depending if it is changed to the left or right. 


sound_trigger.py 


> Language: Python 3 


Choosing sounds 

We found short sounds were generally best, 
but longer sounds can be useful at the beginning or 
end of your run. We copied a lot of sounds from the 
Scratch media library from the path /usr/share/ 
scratch/Media/Sounds into our sounds directory. 
Make sure that are all .wav files, because that 
suffix gets added automatically to the file names. 
Note that the slot sensor will read as a logic zero 
with no ball, whereas a reflective sensor will read 
high in the absence of a ball. There are lots of 
suitable sounds available online as well. 


We have looked at adding optical sensors to 

detect where a ball is, be it on a track ora tile. 

Next month we will look at how to add different 
sorts of LED displays to enhance your GraviTrax 
layout. In the meantime, if GraviTrax is new to you, 
then have a play with the different layouts in the 
accompanying booklet. 
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#!/usr/bin/env python3 
# GraviTrax Sound Trigger 
# By Mike Cook September 2019 


import time 

import pygame 

import os 

import RPi.GPIO as io 


pygame. init() 

pygame.display.set_caption("GraviTrax Sound Trigger") 
os.environ[ 'SDL_VIDEO_WINDOW_POS'] = ‘center’ 
pygame.mixer.quit() 

pygame.mixer.init(frequency = 22050, size =- 16, channels = 
buffer = 512) 

pygame.event.set_allowed(None) 


25 


pygame.event.set_allowed([pygame.KEYDOWN, pygame.QUIT, pygame. 


MOUSEBUTTONDONWN , 
pygame . MOUSEBUTTONUP ] 
) 
textHeight=18 
font = pygame.font.Font(None, textHeight) 
backCol = (160, 160, 160) ; lineCol = (128, 128, @) 
hiCol = (@, 255, 255) 


def main(): 
global screen, lastIn, rows 
initI0() 
rows = len(inPins) 
screen = pygame.display.set_mode([390, 34 + 40*rows], 
@, 32) 
init() ; pendPlay = [@]*rows 
nowIn = [@]*rows; pendTime = [@.0]*rows 
drawScreen() 
while True: # repeat forever 
checkForEvent() 
for i in range(Q, rows): 
nowIn[i] = io.input(inPins[inPin[i]]) 
if lastIn[i] != nowIn[i]: 
lastIn[i] = nowIn[i] 
tmatch = trigNum[i]-1 # match trigger 
if tmatch == 2: 
tmatch = nowIn[i] 
if trigNum[i] != @ and nowIn[i] == tmatch: 
pendPlay[i] = soundFX[soundNumber[i]] 
pendTime[i] = time.time() + delayTime[i] 
for i in range(@, rows): # check what to play now 


if pendTime[i] > 0.0 and time.time()>=pendTime[i]: 


pendPlay[i].play() ; pendTime[i] = 0.0 
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DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/dhaAam 


047. 
048. 
049. 
050. 
Q51. 
Q52. 
Q53. 
Q54. 


Q@55. 
056. 
Q57. 
058. 
Q59. 
e060. 
061. 


062. 


063. 
064. 
065. 


066. 
067. 
068. 
069. 
070. 


e071. 


072. 
073. 
074. 
75. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
85. 
086. 
087. 
088. 


def init(): 
global incRect, decRect, icon, decRect, voiceRect 
global inPin, soundNumber, delayTime, triggerRect 
global lastIn, trigNum, trigIcon 
lastIn = [@]*rows 
loadResources() 
icon=[pygame. image. load( 
“icons/"+str(i)+".png").convert_alpha() 
for i in range(@,2) 
] 
incRect = [pygame.Rect( (8,0), (15,15))]*rows*3 
decRect = [pygame.Rect((9,@),(15,15))]*rows*3 
for j in range(@,3): 
for i in range(@, rows): 
incRect[i+j*rows] = pygame.Rect((76 + j*80, 
30 + i*4@),(15, 15)) 
decRect[i+j*rows] = pygame.Rect((76 + j*80, 
5@ + 1*40),(15, 15)) 
triggerRect = [pygame.Rect((@, @), (20, 20))]*rows 
trigNum = [@]*rows 
trigIcon = [pygame.image. load( 
"icons/trig"+str(i)+".png").convert_alpha() 
for i in range(0,4) 
] 
voiceRect = [pygame.Rect((@,@), (15,15))]*rows 
for i in range(®, rows): 
triggerRect[i] = pygame.Rect((10, 36 + 40*i,20, 
20)) 
voiceRect[i] = pygame.Rect((268, 39 + 
i*4@), (100, 20)) 
sounds = rows + len(soundNames) 
inPin = [1]*rows ; soundNumber = [@]*sounds 
for i in range(®, rows): 
inPin[i] = i 
for i in range(@, len(soundNames) ): 
soundNumber[i] = i 
delayTime = [@.0]*rows 


def initIO(): 
global inPins 
inPins = [24, 23, 22, 27, 17, 4, 15, 14] 
io.setmode(io.BCM); io.setwarnings(False) 
io.setup(inPins, io.IN, pull_up down = io.PUD_UP) 


def loadResources(): 

global soundFX, soundNames 

soundNames = ["owl", “Breaking Glass", 
"ComputerBeeps1", 


"CymbalCrash", "Fairydust", "Dogi", 
"Zoop", "Ya", "Pop" 
] 
soundFX = [pygame.mixer.Sound( 
“sounds/"+ soundNames[effect]+".wav") 
for effect in 
range(@, len(soundNames) ) 


] 


def drawScreen(): 
screen. fill(backCol) 
for i in range(Q,len(incRect)): 
decrement icons 
screen.blit(icon[@], (incRect[i]. 
left, incRect[i].top) ) 
pygame.draw.rect(screen, lineCol, incRect[i],1) 
screen.blit(icon[1], (decRect[i].left, 
decRect[i].top)) 
pygame.draw.rect(screen, lineCol, decRect[i], 


# increment / 


1) 
for i in range(@,rows): # draw all triggers 
screen.blit(trigIcon[trigNum[i]], 
(triggerRect[i].left, 
triggerRect[i].top) 
) 
drawwords("Trigger", 5, 8, (@, @, @), backCol) 
drawwords("GPIO", 70, 8, (@, 8, 9), backCol) 
drawwords("Delay", 138, 8, (@, 8, @), backCol) 
drawwords("Sound", 218, 8, (@, 8, @), backCol) 
updateValues() 


def updateValues(): 
for i in range(@,rows): 


drawWords(str(inPins[inPin[i]]) +"  ", 48, 
39 + i*40, (0, @, 0), 
backCol 
) 
drawwords(" " + str(round(delayTime[i], 1)) + 


" "412, 39 + i*49, 
(®, @, @), backCol 
) 
pygame.draw.rect(screen, backCol, voiceRect[i], 
@) 
drawwords(str(soundNames[soundNumber[i]]), 272, 
39 + i*40, (2, 2, 2), 
backCol 


) 
pygame . display. update() 
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sound_trigger.py (continued) 


> Language: Python 3 


126. def drawWords(words, x, y, col, backCol) : 


127. textSurface = font.render(words, True, col, 
backCol) 

128. textRect = textSurface.get_rect() 

129. textRect.left = x # right for align right 

130. textRect.top = y 

131. screen.blit(textSurface, textRect) 

132. return textRect 

133. 

134. def handleMouse(pos): # look at mouse down 

135. global pramClick, pramInc, trigClick 

136. #print(pos) 

137. trigClick = -1 

138. for i in range(@, rows): 

139. if triggerRect[i].collidepoint(pos) : 

140. trigClick = i 

141. pygame.draw.rect(screen, hicol, 
triggerRect[i], 2) 

142. pygame .display.update() 

143. pramClick = -1 

144. pramInc = @ 

145. for i in range(@, len(incRect)): 

146. if incRect[i].collidepoint (pos): 

147. pramClick = i ; pramInc = 1 

148. pygame.draw.rect(screen, hiCol, 
incRect[pramClick], 1) 

149. pygame.display.update() 

150. for i in range(@, len(decRect)): 

151. if decRect[i].collidepoint(pos): 

152. pramClick = i ; pramInc = -1 

153. pygame.draw.rect(screen, hiCol, 
decRect[pramClick], 1) 

154. pygame . display. update() 

155. 

156. def handleMouseUp(pos): # look at mouse up 

157. global soundNumber, delayTime, inPin 

158. if trigClick != -1: 

159. trigNum[trigClick] += 1 

160. if trigNum[trigClick] > 3: 

161. trigNum[trigClick] = @ 

162. pygame.draw.rect(screen, backCol, 
triggerRect[trigClick], @) 

163. screen.blit(trigIcon[trigNum[trigClick]], 
(triggerRect[trigClick].left, 

164. triggerRect[trigClick].top) ) 

165. updateValues() 

166. if pramClick != -1: 

167. if pramClick < rows: # GPIO Coloumn 

168. inPin[pramClick] += pramInc 

169. inPin[pramClick] = 


constrain(inPin[pramClick], @, rows-1) 


170. 
171. 
172. 


173. 
174. 
175. 
176. 
177. 
178. 
179. 


180. 
181. 
182. 
183. 


184. 
185. 


186. 
187. 


188. 
189. 


190. 
191. 
192. 
193. 
194. 
195. 
196. 
197. 
198. 
199. 
200. 
201. 
202. 
203. 
204. 
205. 
206. 
207. 
208. 
209. 
210. 
211. 
212. 
213. 


elif pramClick < rows*2: # Delay Coloumn 
delayTime[pramClick-rows] += (pramInc / 10) 
delayTime[pramClick-rows] = 
constrain(delayTime[pramClick - rows], 
8, 5 
) 
if delayTime[pramClick - rows] < @.@1: 
delayTime[pramClick - rows] = @ 
elif pramClick < rows*3: # Sound coloum 
soundNumber[pramClick - rows*2] += pramInc 
soundNumber[pramClick - rows*2] = 
constrain(soundNumber[pramClick 
- rows*2], @, len(soundNames) -1) 
if pramInc !=0: 
if pramInc < @: 
screen.blit(icon[1], 
(decRect[pramClick].left, 
decRect[pramClick].top)) 
pygame.draw.rect(screen, lineCol, 
decRect [pramClick],1) 
else: 
screen.blit(icon[@], 
(incRect[pramClick].left, 
incRect[pramClick].top) ) 
pygame.draw.rect(screen, lineCol, 
incRect[pramClick], 1) 
updateValues() 


def constrain(val, min_val, max_val): 
return min(max_val, max(min_val, val)) 


def terminate(): # close down the program 
pygame.mixer.quit() 
pygame.quit() # close pygame 
os._exit(1) 


def checkForEvent(): # see if we need to quit 
event = pygame.event.poll() 
if event.type == pygame.QUIT : 
terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 
terminate() 
if event.type == pygame.MOUSEBUTTONDOWN : 
handleMouse(pygame.mouse.get_pos()) 
if event.type == pygame.MOUSEBUTTONUP : 
handleMouseUp(pygame.mouse.get_pos()) 
if _name_ == '_ main_': 
main() 
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Design retro game 


maps and levels 
in PICO-8 


Take your game design to the next level by learning to use 
P|CO-8's map editor. Draw terrain and build your first level! 


editor by selecting it from the editor menu at the 
top right. At first glance, it looks a lot like the 
sprite editor, with the same sprite sheets and 
drawing tools at the bottom of the screen. The 
difference is that, instead of plotting coloured 
pixels, the map editor paints with our finished 
sprites. Try this out by selecting a sprite and 
drawing on the canvas above. 


one-screen space shooter into a scrolling 
shoot-’em-up! You’ll learn how to use 

Dan PICO-8’s handy map editor to quickly and easily 
Lambton-Howard draw out levels, and how to use the sprite editor to 
create terrain tiles. We’11 talk about using sprite 
flags to distinguish between background and 
foreground and how to spawn enemies. Speaking 
of which, we’ll also talk about level design basics 
and introduce a new turret enemy type to add 
extra spice and challenge to your game. There’s 
lots to get through, so let’s get started! 


| n this tutorial we will be turning our simple 


Dan is an 
independent game 
designer based in 
Newcastle upon 
Tyne, where he is 
lucky enough to 
make games for 
his PhD. 


@danhowardgames 


Chunks of dirt 

We can’t build a level out of enemy and 
player sprites — that would be sheer insanity! 
PICO-8’s map editor is grid based, so we’ll need 
to create some new terrain sprites that we put 
together as tiles. Figure 1 shows a 3x3 square of 
sprites that can be tiled easily, with a couple of 
variations along the side. Switch to the sprite 
editor and create something similar. We’ve chosen 
suitably weird-looking purple asteroids for our 
terrain, and we’ve also created simple background 
sprites out of a chequer-board ‘dither’ pattern that 
we can use to imply depth. 


A blank canvas 

Much like every other aspect of game 
development, PICO-8 has a quick and easy 
solution for designing levels. Switch to the map 


| You'll Need 


» PICO-8 1 


magpi.cc/pico8 ea mead | ie 


aa! 


» Raspberry Pi 


» Keyboard 
and mouse 


Tiles for miles 

Now we have our raw level-making 
material, let’s start working with it. Switch back 
to the map editor. You can zoom the canvas with 


Figure 1 A big block 
of terrain tiles makes 
a good palette with 
which to paint your 
levels. Distinguish 
between background 
and foreground with 
sprite flags 
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the mouse wheel and pan with the pan tool. Hit 
the SPACE bar to view gridlines, and you’ll see that 
your canvas is 12864 tiles, with grid reference 

(0, 0) being the top-left tile. As PICO-8’s screen 
resolution is 128x128 pixels, and each tile is 8x8 


Draw your level 
in PICO-8's map 
editor for enemy 
and terrain 
placement 


— ee ee oe oe ee oe oe 


Create terrain 
tiles that can be 
combined for lots 
of possibilities 


pixels, a single screen in PICO-8 is 1616 tiles. Use 
your terrain sprites to draw some asteroids in the 
top-left 16x16 tiles of the canvas. 


<= ages = 


Mapping it all out 

Let’s see what this looks like in game. 
First of all, comment out the enemy wave code, 
so that we can explore our level without being 
rudely interrupted by space blobs. You can 
use --[[..]] for block comments. Next, add 
map(@,0,@,0,128,64) to_draw() just after where 
we draw the background stars. This function tells 
PICO-8 to draw a 128x64 block of tiles starting 
from tile reference (0,0) on the map to coordinates 
(0,0) on the screen. Run your game and you should 
now see your asteroids. Great work, but it’s all 
rather static — let’s get this level scrolling! 


Look into the camera 

To turn our game into a scrolling shoot- 
>em-up, we will need to use a scrolling camera. 
Declare new variables camx,camy = 0,@in_init() 
for the camera’s coordinates. Next, add camx+=1 to 
the start of _draw(), followed by camera(camx, camy) 
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Sprite flags 


Sprite flags are 
extraordinarily 
useful for lots of 
things, such as 
distinguishing 
between 
drawing layers or 
marking objects 
that collide. 


= 
. 
‘al 
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which sets the top left of PICO-8’s built-in camera 
to these coordinates. We’ve modified our player, 
laser, and draw background, score, and game- 

over message code to be locked to the new camera 
coordinates. As the map is only eight screens long, 
we’ve also written a cheeky bit of code to move the 
camera and player to the next row on the map when 
it reaches the end. 


™ Modifying the code is mainly a matter of 
changing boundaries to be set to camx 
and camy instead of arbitrary values 


Ared flag 

Modifying the code is mainly a matter 
of changing boundaries to be set to camx and 
camy instead of arbitrary values; we’ll also add 
player.x+=1 to __update() so that the player scrolls 
with the camera. See the code listing for more 
details. You’ll have probably noticed that we can 
fly straight through the terrain unimpeded, so 
let’s add terrain collision detection. We’ll use 
sprite flags to do this. Set the sprite flags (those 
radial buttons above the sprite sheet tabs in the 
sprite editor) of each of your terrain tiles so that 
flag o is on. It should light up red. 


Design retro game maps and levels in PICO-8 | magpicc | 59 


WN Magri | TUTORIAL 


A Our level introduces 
new elements 
one by one and 
increases in 
difficulty at the end 
of each segment 


TopTip & 


Top tile tips 


Creating good- 
looking terrain 
tiles that work 
well with each 
other isn't easy; 
thankfully, a quick 
web search will 
reveal hundreds 
of examples to 
learn from. 


07 Deep impacts 

Sprite flags are a way of ‘marking’ sprites. 
In this case, we will treat any sprite with flag o 
as solid terrain that our player can crash into. To 
actually detect the collision, we’ll create a new 
function player_terrain_collision() which will 
check four points of a square around the player’s 
coordinates, retrieve whatever sprite is there, and 
return true if that sprite has flag 0 activated. Then 
we’ ll add few lines in our update loop that’! call 
that new function and kill the player if it returns 
true. We nearly have everything in place! 


M t's a good idea to start 
Simple and gradually 
increase the challenge @ 


Enemy placement 

Next, we want to slightly modify our enemy 
code so that instead of spawning in endless waves, 
we can place them in our level and they will attack 
when they appear on camera. See the code listing 
for the changes. To place enemies in the level, we 
will use one of our existing enemy sprites in the 
map editor. Then we will add a few lines to _init() 
that will check every map tile for enemy sprites and 
spawn enemies when it finds them — simple! Now 
that we can place terrain and enemies, we can begin 
the level design proper. 


Flow state 

Level design is as much an art as itisa 
science. For every rule of good level design, there 
are a hundred examples to prove it wrong. That 
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being said, for your first few levels there are 
certainly some guiding principles you can follow. 
It’s a good idea to start simple and gradually 
increase the challenge as your players become 
better at the game. This is to keep players ina 
satisfying state of ‘flow’ where a level is not too 
easy as to be boring, or too hard to be frustrating. 


Difficulty curve 

In our space shooter, difficulty is 
determined by the number and location of 
enemies and the placement of terrain. Modifying 
these factors allows us to control the challenge 
and ideally create a smooth ‘difficulty curve’. In 
our level, enemies are introduced singularly at 
first, then in increasing numbers. Terrain is then 
introduced, then enemies and terrain, and lastly 
challenging combinations of both. You can see how 
new elements are introduced one at a time and 
in situations that allow the player to learn their 
behaviour before the difficulty is increased. 


Reinforcements 

Variety is the spice of life and although 
our green blobs from space have a certain appeal, 
it is the introduction of new elements, or new 
combinations, that keeps a level entertaining. 
That’s why we’ve created a new enemy type, the 
turret. You can see the code, but essentially it is 
a malignant mutant that fires a mucus projectile 
at the player every few seconds. How delightful! 
This gives us more possibilities for interesting 
combinations with the other elements in our game; 
for example, turrets in an asteroid field or amongst 
waves of enemies. 


A happy ever after? 

So, your player has defeated every wave of 
enemy, dodged every asteroid, and made it to the 
end of your level. What now? Well, the polite thing 
to do would be to reward them in some way, or give 
them one final gigantic boss battle. Either way, 
we will need a congratulations message to tell the 
player that they are the saviours of mankind. Asa 
final touch, we’ve added a message that will show 
when the player makes it all the way to the end. 
Well done space fighters, the galactic federation 
thanks you! 
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part5code.p8 


» Language: Lua 


DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/eDDppk 


001. 
002. 
003. 
004. 
005. 
e006. 
007. 
008. 
ee9. 
010. 


Q11. 
Q12. 
013. 
e14. 
15. 
016. 
017. 
018. 
e19. 
Q20. 
Q21. 
@22. 
@23. 
@24. 
@25. 
Q26. 
027. 
028. 
@29. 
030. 
Q31. 
Q32. 
Q33. 
Q34. 


Q35. 
Q36. 
037. 
038. 
Q39. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
Q51. 
Q52. 
053. 
@54. 
@55. 
Q56. 
Q57. 


058. 
@59. 
060. 


--new code reference 
--**kin _init()*** 
camx,camy = @,@--camera coordinates 
--check each map tile and spawn enemies 
for mapx=0,127 do 
for mapy=0,63 do 
local sprite = mget(mapx,mapy) --get sprite 
if sprite==2 then 
create_enemy(mapx*8,mapy*8) 
--set map tile to blank so we dont draw it 
as background 
mset(mapx,mapy, @) 
end 
if sprite==3 then --turret 
create_turret (mapx*8,mapy*8) 
mset(mapx,mapy, @) 
end 
end 
end 
--**kin _update()*** 
--make player scroll with screen 
player.x+=1 
--change player boundary locking to camera 
player. x=mid(camx, player.x,camx+120) 
player. y=mid(camy,player.y, camy+120) 
--kill player if hits terrain 
if player_terrain_collision() then 
gameover = true 
create_explosion(player.x, player.y, 20) 
sfx(1) 
music(-1) 
end 
--change to laser boundary 
laser.x+=5 --speed up laser 
if laser.x>camx+13@ then --delete laser if off 
camera 
del(lasers, laser) 
end 
--change so enemies only attack when on camera 
for enemy in all(enemies) do --enemy update loop 
if enemy.name=='blob' then enemy.x-=1 end 
if enemy.x<camx+130 and enemy.y<camy+128 then 
--[[rest of code here] ] 
if enemy.name=='turret’ then 
if enemy.animtimer%60==8 then 
create_mucus(enemy.x,enemy.y) 
end 
end 
if enemy.name=='mucus' then 
enemy . x+=enemy.vx 
enemy. y+=enemy.vy 
end 
if enemy.x<camx-8 then 
del(enemies, enemy) 
end 
end 
end 
--***in _draw()*** 
if not gameover then camx+=1 end --increment camera 
x value 
if camx>=1024 then --if cam off right edge of map 
camy+=128 --move down one row 
camx=-128 --move to left of map 


061. 


062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
71. 
072. 
073. 
074. 
75. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
85. 
086. 
087. 
088. 
089. 


090. 
91. 


92. 


093. 
94. 
95. 
096. 
097. 
098. 
99. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
110. 


111. 
112. 
113. 
114. 
115. 
116. 
117. 
118. 


player.x-=1152 --full width of map +1 
screen(1024+128) 

player. y+=128--down one screen 
end 


camera(camx,camy)--set camera 
map(@,0,0,0,128,64)--draw map onto screen 
--update to background to lock to camera 
rectfill(camx, camy, camx+128, camy+128,1) 
for star in all(stars)do 
star.x -= star.speed 
pset(star.x+camx, star.y+camy, 7) 
if star.x < @ then 
star.x = 130 
star.y=rnd(128) 
end 
end 
--update to only animate blob enemy 
if enemy.name=='blob' then 
enemy.sprite = enemy.sprites[flr--[[etc]]] 
end 
--update to gameover text to lock to camera 
if gameover then 
print('game over',camx+50, camy+64, 7) 
end 
--show score on screen 
print('score: '..score, camx+2, camy+2,7) 
--***other functions*** 
function player_terrain_collision() 
for newx=0,6,6 do --nested for loops generate 4 
points 
for newy=0,7,7 do 
--divide by 8 to convert pixels to map 
coords 
local sprite = mget( 
(player.x+newx)/8, (player.y+newy)/8) 
if fget(sprite,@) then return true end 
end 
end 
return false 
end 
--new turret enemy 
function create_turret(x,y) 
local turret={x=x, y=y, sprite=3,name='turret'} 
turret.animtimer=0 
add(enemies, turret) 
end 
--new mucus projectile 
function create_mucus(x,y) 
--maths that sets mucus velocity towards player 
local angle=atan2(player.x+32-x,player.y-y) 
local velocityx=cos(angle)*1.5 
local velocityy=sin(angle)*1.5 
local mucus={ 
x=x, y=y, vx=velocityx, vy=velocityy, sprite=50} 
mucus .name= ‘Mucus * 
mucus. animtimer=0 
add(enemies, mucus) 
end 
--add name to blob enemy 
function create_enemy(x,y) 
enemy .name='blob' 
end 
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is a software 
engineer working 
for Raspberry Pi, 
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the Raspberry 
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Making menus 
with C and GTK 


Create menu bars with drop-down menus, and also pop-up menus 


any applications have a menu bar at the 
M top of the main window. GTK provides a 

number of widgets which can be used to 
create either menu bars or pop-up menus. 
The building block of menus is the GtkMenultem 
widget. Each entry ina menu is a GtkMenultem, 
which has a text label associated with it. A GtkMenu 
widget is used to hold one or more GtkMenultem 
widgets, creating a single menu of the sort seen as a 
pop-up or when an item on an application menu bar 
is selected. 


Menu bars 

A GtkMenuBar can be displayed at the top of an 
application’s window; this contains a number of 
GtkMenultems, each of which provides the name 
for a GtkMenu, as described above. 

It can be slightly confusing to consider that a 
GtkMenultem is both a member of a menu and the 
name of the entire menu, but hopefully an example 
will make things a bit clearer. Here’s the code for an 
application with a menu bar: 


An Introduction 


toC & GUI | 
Programming 


INTRODUCTION 


CaGul 


For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 156 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 
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void main (int argc, char *argv[]) 
{ 
gtk_init (&argc, &argv); 


GtkWidget *win = gtk_window_new ( 
GTK_WINDOW_TOPLEVEL ) ; 

GtkWidget *btn = gtk_button_new_with_label ( 
"Close window") ; 

g_signal_connect (btn, "clicked", 
G_CALLBACK (end_program), NULL); 

g_signal_connect (win, "delete_event", 
G_CALLBACK (end_program), NULL); 


GtkWidget *mbar = gtk_menu_bar_new (); 
GtkWidget *vbox = gtk_vbox_new (FALSE, 5); 
gtk_box_pack_start (GTK_BOX (vbox), mbar, 
TRUE, TRUE, Q); 
gtk_container_add (GTK_CONTAINER (win), 
vbox) ; 
GtkWidget *file_mi = 
gtk_menu_item_new_with_label ("File"); 
gtk_menu_shell_append ( 
GTK_MENU_SHELL (mbar), file mi); 


GtkWidget *f_menu = gtk_menu_new (); 
gtk_menu_item_set_submenu (GTK_MENU_ITEM ( 
file_mi), f_menu); 


GtkWidget *quit_mi = 
gtk_menu_item_new_with_label ("Quit"); 

gtk_menu_shell_append (GTK_MENU_SHELL ( 
f_menu), quit_mi); 

g_signal_connect (quit_mi, "activate", 
G_CALLBACK (end_program), NULL); 


gtk_box_pack_start (GTK_BOX (vbox), btn, 
TRUE, TRUE, @); 
gtk_widget_show_all (win); 


File 


Close window 


Peeeeeeeeeey 
Sete eR Renee ee 


gtk_main (); 
t 


First, we create a menu bar to hold the 
application menus. 


GtkWidget *mbar = gtk_menu_bar_new (); 


We need to add it to the window; as with any 
other widget, to put it at the top of the window, 
we need to create a vertical box, pack the menu 
bar at the top and the rest of the window contents 
beneath it, and then put the vertical box into the 
window’s container. 


GtkWidget *vbox = gtk_vbox_new (FALSE, 5); 

gtk_box_pack_start (GTK_BOX (vbox), mbar, TRUE, 
TRUE, @); 

gtk_container_add (GTK_CONTAINER (win), vbox) ; 


We then create a menu item to hold the 

‘File’ menu, and add it to the menu bar using 
gtk_menu_shell_append — a menu shell is anything 
which can hold menu items; in practical terms, this 
is either a menu or a menu bar. 


GtkWidget *file_mi = 
gtk_menu_item_new_with_label ("File"); 

gtk_menu_shell_append (GTK_MENU_SHELL (mbar), 
file_mi); 


At this point we have a menu bar with the single 
item ‘File’ on it - we now need to create a menu to 
associate with the menu item. 
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Figure 1b 


File 
Quit 


| Keesecsesess 


A Figure1A 
GtkMenuBar with 
a single GtkMenu 
(‘File’), which 
contains a single 
GtkMenultem (‘Quit’) 


GtkWidget *f_menu = gtk_menu_new (); 


We then use gtk_menu_item_set_submenu to set our 
created menu as a submenu of the ‘File’ menu item. 


gtk_menu_item_set_submenu (GTK_MENU_ITEM ( 
file_mi), f_menu); 


At this point, we have a menu bar with the 
‘File’ item on it, and an empty menu as the 
submenu of that menu item. We now create a 
menu item to hold the ‘Quit’ option, and we 
use gtk_menu_shell_append to add this to the 
‘File’ menu. 


™ GTK provides ad number of 
widgets which can be used 
to create either menu bars 
Or pop-up menus @ 


GtkWidget *quit_mi = 
gtk_menu_item_new_with_label ("Quit"); 

gtk_menu_shell_append (GTK_MENU_SHELL (f_menu) , 
quit_mi); 


We now have a menu bar with a single menu (‘File’), 
which contains a single option (‘Quit’), but as yet 
that option doesn’t do anything. To make the menu 
item do something, we connect a handler callback 
to its activate signal with g_signal_connect, just as 
with a button. 
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File 


Close wind 


A Figure 2 A pop-up 
menu, launched 
from a button 


Qui 


The code to connect our existing end_program 
handler to the ‘Quit’ menu item is: 


g_signal_connect (quit_mi, "activate", 
G_CALLBACK (end_program), NULL) ; 


That’s it — you now have a working ‘Quit’ menu 
option in your application (Figure 1). You can use 
the same process to add as many menus and menu 
items as you want to a menu bar. 

Note that the function we used to adda 
menu to the item in the menu bar was called 
gtk_menu_item_set_submenu — in effect, the menu 
is regarded as a submenu of the top-level menu 
item in the menu bar. You can use exactly the 
same function to create an actual sub-menu 
from a menu item in a menu, and can nest 
these calls as deeply as you want to create the 
sort of hierarchical menu structure that more 
complex applications use. (From a usability point 
of view, it’s wise to stick to no more than one 
additional level of submenu - having a menu 
create a submenu from some items is fine, 
but if you are creating even more submenus 
from the submenus themselves, the users may 
get confused!) 


Pop-up menus 

The menu bar is the most common way of adding 

a menu to an application, but it is also possible to 
use very similar code to add pop-up menus that 
are produced when you click buttons, tree views, or 
various other widgets. 
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fm The menu bar is the most 
common way of adding a 
menu, but it is possible to 
use very similar code to 
ddd pop-up menus @ 


Create the following handler, and connect it to 
the clicked signal on a button. 


void button_popup (GtkWidget *wid, gpointer ptr) 
{ 
GtkWidget *f_menu = gtk_menu_new (); 
GtkWidget *quit_mi = 
gtk_menu_item_new_with_label ("Quit"); 
gtk_menu_shell_append (GTK_MENU_SHELL (f_menu), 
quit_mi) ; 
g_signal_connect (quit_mi, "activate", 
G_CALLBACK (end_program), NULL); 


gtk_widget_show_all (f_menu); 
gtk_menu_popup (GTK_MENU (f_menu), NULL, NULL, 
NULL, NULL, 1, 
gtk_get_current_event_time ()); 


This creates a menu with the single item ‘Quit’, as 
before, but instead of putting it into a menu bar, 
it uses the gtk_menu_popup function to display it 
at the mouse cursor position. When you press the 
button to which this handler is connected, the 
menu will be displayed over the button, and it can 
then be selected from there (Figure 2) 

The gtk_menu_popup function is designed for 
use from very low-level system mouse events — 
when called from a button handler, most of the 
event information isn’t needed, which is why 
most of its arguments are set to NULL. The only 
ones which matter are the first argument - the 
menu to pop up, and the last two, which are the 
code for the button which was pressed (1 for the 
left mouse button) and the time at which the 
button was pressed (which is obtained from the 
gtk_get_current_event_time function). 

This example shows a pop-up being generated 
by a button press, but it can also be linked to 
mouse events on many other widgets. H] 
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wiTH RASPBERRY PI 


This isn’t just a book about a computer: it’s 
a book with a computer. Almost everything 
you need to get started with Raspberry Pi 

is inside this kit, including a Raspberry 

Pi 3A+ computer, an official case, and 

a 16GB NOOBS memory card for the 
operating system and storage. 


116-page guide shows you how to master 
Raspberry Pi in easy steps: 


@ Set up your Raspberry Pi 3A+ for the first time 
@ Discover amazing software built for creative learning 
@ Learn how to program in Scratch and Python 
@ Control electronics: buttons, lights, and sensors 
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Warning! 
Mains electricity! 


Some of these projects 
involve mains electricity. We 
recommend substituting an 
Energenie where you can, if 

you plan to follow them. 


magpi.cc/energenie 


Get ready for cooking this holiday season 
with these kitchen tips and projects! 


creative in the kitchen. For others, it can be a chore. Here in the 

pages of The MagPi magazine, though, we all overlap on the Venn 
diagram (or Arnold Schwarzenegger/Carl Weathers handshake) as 
makers and tinkerers and hackers. 

We can make cooking better. Easier. Perhaps a little more fun for 
everyone. So, we’ve put together a tutorial for a little Raspberry Pi- 
powered kitchen aid, and found a selection of fun projects that might 
inspire you to hack your kitchen. Just in time for the upcoming holiday 
feasts as well. 


EF or those of us who enjoy cooking, it can be a lot of fun to get 


Measure temperature precisely with alarms with our cooking aid 


A The wiring diagram 
for the temperature 
sensor and buzzer 


t You'll Need 


> Display-O-Tron 3000 
magpi.cc/ihxSPF 


> DS18B20 
temperature probe 
(waterproof) 


> Buzzer 


> Breadboard, wires 


'— a eg 


Ve 
Data 
Ground 


Wire it up 

With your Raspberry Pi turned off, 
follow the wiring diagram (above) to set up our 
temperature sensor and buzzer. The sensor we’re 
using is a digital 1-Wire device and will require 
extra software to be set up for it to work. Once 
it’s all wired up, though, you can boot up your 
Raspberry Pi and install the Display-O-Tron 
software from the Terminal with: 


curl -sS get.pimoroni.com/displayotron | bash 


Probe setup 
Enter the following: 


sudo nano /boot/config.txt 

Add this line to the end of the file: 
dtoverlay=w1-gpio, gpiopin=16 

Reboot the Raspberry Pi and the open up the 


Terminal again. We need to activate the relevant 
kernel modules with: 


sudo modprobe wi-gpio 
sudo modprobe wi-therm 


Move into the wi devices folder with cd 
/sys/bus/w1/devices/ and use Is to list out 
what’s there. It might take a few seconds to 
show up, but a folder with something like 
28-000006d85491 will appear. Make a note 
of this folder and number. 


Get the code 

Download the code file temperature.py. 
Remember the number we noted down earlier? 
This is the serial for the thermal sensor and 
you’ ll need to edit line 19 in the Python file to 
replace 28-@00006d85491. While you’re editing the 
file, you can also change the default temperature 
in set_temp. 

Save and go back to the Terminal and enter sudo 
nano /etc/rc.local. At the end of the file, add 
the following so this script runs at boot (pointing 
towards where you saved the file): 


python /home/pi/temperature.py & 


Reboot, and test it out! 


A You can take the temperature of water in a kettle and be 
alerted by a buzzer when it has boiled 
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ME Waghi | FEATURE 


MAKER: designforhire 


VW Anondescript 
larder door that 
you wouldn't 
look twice at 


The humble kitchen computer is an excellent 
tool for having a bit more info than TV or radio 
at your disposal. If you have a lack of counter 
space, you might be trying to figure out where 
to put one. Well, how about hiding it behind 
a calendar? 
This particular build uses a sixties or seventies 
spy drama way of revealing the screen by rolling 
down the calendar at the touch of a button. A 
hidden keyboard is also revealed, allowing you 
control the computer a bit more manually. 
Genius. A bit more fun than installing a screen 
under a cabinet at least. 


magpi.cc/byaPGR 


MAKER: Nathan Broadbent 


“TI was inspired by this post on Reddit, titled 
‘Food items should have QR codes that instruct 
the microwave exactly what to do. Like high for 2 
minutes, let stand 1 minute, medium 1 minutes’,” 
says Nathan on his blog. So he did just that. 

This build is about six years old now; however, 
smart microwaves are only just starting to hit 
the shelves for consumers. Instead of QR codes, 
Nathan opted for the standard UPC barcodes you 
find on food, and so do the consumer models. For 
Nathan’s build, we like the extra level of detail 
on the new touchpad, including a lovely little 
Raspberry Pi logo. 


i ave 
aspberry pie In the microw 


nalso supplies a recipe to make a f 


A Natha' magpi.cc/q3iWaQ 


Jeata fae 
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MAKER: Bryan Mayland 


Smoking meat can be a lot of work, and not very 
easy. One of the keys to success is keeping the 
temperature inside your smoker as consistent as 


possible. As you’re li 
such as more charco 
going, it only adds to 
This is where some 
Pit Probe comes in. It 
in your smoker/BBQ, 


uses all this informat 
smoker, allowing for 


kely going to have to add fuel 
al) to your smoker to keep it 
the complexity. 

thing like the HeaterMeter 
measures the temperature 
the internal temperature of 


the meat, and ambient temperature outside. It 


on to control airflow into the 
the temperature to be more 


easily maintained. It also includes a handy web 
interface. Maybe you should try a smoked turkey? 


magpi.cc/Hy7quP 


A |f this is your idea of a festive feast, then we'd 
happily accept an invitation 


4 Youcan buy a kit like this, or make one from =, 
scratch yourself 


temoeralures 


oast, grill, or smoke your meat to perfection 


Steak (rare) 
TEMPERATURE 52°C 


Beef (slow cooked) 
TEMPERATURE 63°C 


Lamb (medium) 
yf 

Sind 

———— 


e 
rey Chicken 
weg §=TEMPERATURE 74°C 


Turkey Steak (medium rare) 


TEMPERATURE 60°C TEMPERATURE 71°C 


@ TEMPERATURE 74°C 


<2) 


Fish 
TEMPERATURE 63°C 


Pork 
TEMPERATURE 63°C 


Steak (medium) 
TEMPERATURE 66°C 


ME Waghi | FEATURE 


hot ¥ 


MAKER: RiquezJP 


This project is more software-based, so it’s 
something you can definitely look into before 
you start sawing holes into a door. All you need 
is a Spare monitor, a Raspberry Pi to power it, and 
a suitable space in your kitchen. 

It includes two distinct modes: TV mode and 
web browser mode. TV mode makes use of live 
YouTube channels for world news or music, while 
also displaying a clock, the weather, and a BBC 
News feed. From the web browser, you can search 
for different recipes. While a little more work to 
set up than an iPad with a smart cover, it’s more 
useful in our opinion. 


magpi.cc/KVNaXv 


MAKER: Chris Synan 


As coffee machines become more complex, 
— the more you can hack them to brew at your 
2:52: _ 7 bidding. There are a few ‘smart’ coffee machine 

: \ hacks out there, but here we’re going to talk about 
iSPRESSO. Not only does it have a pretty good 
tutorial that you can follow if you wish (with a 
supervising adult, of course), it also has pretty 
advanced remote control functions. 

As it’s asmart machine, you can also set some 
timers to preheat the water and such. A good way 
to make sure your morning cup of joe is freshly 
waiting for you when you wake up. 


nl 
3 SOULCHEF 


ispresso.net 


A TV mode is simple and gives you the 
info you need, and some tunes to boot 


0 


A The remote control app gives you a lot of advanced control 
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Bratt 
Brewing beer in your house may be a bit over- 
the-top for some folk. However, the method of 
doing so has many other applications, including 
sous vide-style cooking. While BrewPi can be 
bought as a standalone unit, the website has full 
instructions on how to design and create your own 
— which is a big of an undertaking! 

Scaling it down for a rice cooker to make a water 
bath is a little simpler, although trading in beer 
for pulled pork might not be everyone’s cup of 


tea. Oh yeah, you can make a perfect tea~brewing 
system with it as well. 


MAKER: Elco Jacobs 


brewpi.com A Make your own fridge-based brewery! 


pi Day Pie Pie 
Rema ning 


MAKER: Mike MacHenry 


We’ve all had this problem, and so far there’s 
never been a solution for it: how do you know 
how much pie is left? Thankfully, Mike has 

a solution in the Pie Pie Chart, powered bya 
Raspberry Pi. 

This project weighs the pie at the start of its 
life, pre the first cut, and then gives an accurate 
representation of just how much pie is left once 
slices are taken. It’s accurate to 0.1 percent, 
perfect for planning any late pie snacks in case 
you still want some for breakfast. Hl 


A 86.9% of a pie is an excellent amount of pie to have magpi.cc/FUuepB 


Brew the perfect cup of whatever you desire 


WW iempcrature 65-75°C 9 WR? tempcrature 80-85°C | (WH) tempcrature 90-95°C 


wt lt it 


TEMPERATURE 75-85 °C We TEMPERATURE 85°C we TEMPERATURE 95°C 
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PiArm 


> SBComponents >» magpi.cc/aCndRx > From £279 / $369 


SERVOS: 

6 x smart 
servos — 0.24° 
accuracy, 
0-240’ angle, 
17kg/cm 
torque 


BOARD: 
PiArm Shield - 
on/off switch, 
multiple 
breakout pins 


WEIGHT: 
1.1kg 


MAXIMUM 
ARM 
EXTENSION: 
375mm 
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A full-metal lightweight robotic arm with six smart servos. By Phil King 


e’ve seen entry-level robotic arms 
W for Raspberry Pi before, but PiArm is 

in a different league when it comes 
to build quality and precision movement. All 
the mechanical parts are solid metal, giving the 
assembled arm a very robust structure. Meanwhile, 
its Six Servos are smart ones, giving digital feedback 
on their angle, temperature, and voltage. As well as 
the Basic Kit reviewed here, versions are available 
with a5- or 7-inch LCD touchscreen and speakers. 


You’ll need a spare hour or two to assemble the 
arm, using a large array of parts and different- 
sized screws. While the assembly guide booklet is 
well illustrated (and there’s a video guide online), 
we found a few confusing discrepancies, including 
an annoying bit where we assembled a section, 
only to have to dismantle it again to wire up the 
servos (as revealed on the next page). 

Nor was any servo wiring information supplied 
— SB Components says a video should be uploaded 
to the product page soon. Based on the single 
wiring image shown in the booklet, we daisy- 
chained the servos in the same way (wire from 
servo below going into left socket, then wire from 
right socket to next servo up) and it worked. 

The arm is mounted on a metal base with holes 
to secure a full-size Raspberry Pi. PiArm’s ‘shield’ 
board can then be mounted on the GPIO header, 
in which case it supplies power to your Raspberry 
Pi, or you can connect it via USB. The 7.5V 5A DC 
power supply has a barrel jack with an adapter with 
two wires that connect to two screw terminals on 
the shield - a slightly messy solution. 

The kit also includes metal mounts to adda 
sensor (e.g. ultrasonic) and Camera Module (not 
supplied), although these fit to the base rather 
than the arm itself. 


<q PiArm is available 
with an optional 
5- or 7-inch LCD 
touchscreen 


Port ttySO 
Baudrate 115200 


@ | cose” 


Read write 
Default_Position 
All_Torque_Enable 


sb Components 


Time (ms) 1000 


Add | Delete 
_insert | Modify 


a 


With the arm assembled, you can insert the 
preloaded 16GB microSD card supplied into the 
Raspberry Pi to get started. Our card was blank, 
however, so we needed to install Raspbian and 
clone the PiArm GitHub repo (magpi.cc/TNSLVW). 


Graphical interface 

While the software is based around a PiArm Python 
library, a GUI interface makes getting started much 
easier and lets you program command sequences. 
An image of the arm is shown on screen, with two 
number fields for each of the six servos. First, you 
need to input an address in the Port field to open up 
a serial connection to the arm: ttySo if Raspberry Pi 
is connected via GPIO; ttyUSBo if via USB. 

One way to program the arm is to type in 
numbers for each servo to set an arm position. A 
far simpler way, however, is to disable the torque 
and then manually position the arm to the desired 


P Its clawis good 
at gripping 

objects and 

picking them up 


GROUP NAME 


Camera 


position with your hands and read in the numerical 
servo data. This enables you to quickly store a 
sequence of commands (called a ‘group’) which 
you can then play back; sequences can be saved as 
text files for future reuse. 


REVIEW | Magri Sa 


A GUI interface 
enables you to 
create sequences 
of commands; by 
disabling the torque, 
you can manually 
position the arm and 
read its position 


mM A GUI interface makes getting started 
much easier and lets you quickly program 


command sequences 


Picking it up 

The arm rotates smoothly on its base, thanks to 
ball bearings, and moves fairly quietly. We soon 
managed to get the arm to pick up a keyring with 
its claw and then put it back down again elsewhere. 
We did find the default speed a bit too much, 
though, with the arm’s more sudden movements 
sometimes being powerful enough to lift the base 
suckers off the table! Fortunately, we were able 

to reduce servo speed levels to a preferable level, 
counter-intuitively by raising the setting to 800. 
Other servo parameters, such as angle and voltage 
range, may also be altered using another GUI 
program, although it’s not advisable to do so with 
the arm assembled. 

A PlayStation-style wireless joypad is also 
supplied, enabling you to control the arm 
manually; in this case we found it slow to rotate 
and the arm automatically curled up while rising, 
but you can always alter the Python code to 
customise control. Indeed, you could use the PiArm 
Python library with your own programs. Hl 


Verdict 


Excellent metal 
components and 
smart servos raise 
this robotic arm 
well above the 
level of cheaper 
entry-level 

rivals. The GUI 
interface makes it 
easy to program 
sequences, while 
advanced users 
could create their 
own programs 
based on the 
Python library. 


9, 10 
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A Flirc Raspberry Pi 4 case is a stylish affair, with an 
aluminium case topped and tailed with soft-touch plastic 


Flirc Raspberr 


DIMENSIONS: 
66x91x25 mm 


CASE: 
Aluminium 
housing 


FEATURES: 
Built-in 
heat sink 


Warning! 


Using stress should only 

be done for short periods. 

Watch your Raspberry Pi 
and restart afterwards. 


> Flirc > flire.tv » £16/S16 


y Pi4 


Stylish and clever case with a body that becomes 


g heat sink. By Lucy Hattersley 


e see a lot of cases here at The MagPi, 
W but the Flirc Raspberry Pi 4 case came 

recommended to us via Raspberry Pi’s 
engineering team, so we had to take a look. 

The Flirc Raspberry Pi 4 case comes in two 
halves: the bottom is a soft-touch plastic shell, 
and the top half is milled aluminium coated with 
more soft-touch. The result is a stylish and lovely- 
to-hold case made from solid metal. 

Here’s where things get clever: inside the case 
is a protruding heat sink that reaches down to 
Raspberry Pi 4’s CPU. This turns the whole of the 
aluminium case into a giant heat sink, cooling 
down your Raspberry Pi 4. 

Inside the pack is a square thermal pad (similar 
in substance to Blu Tack). You use this to squidge 
the Raspberry Pi to the heat sink. Putting together 
the case is ludicrously simple: you simply drop a 
Raspberry Pi in the bottom half, attach the thermal 
paste, squidge down the lid, and use four screws to 
hold everything together. 
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Flirc claims that this is “the most beautifully 
crafted Raspberry Pi 4 case” and it’s not a wholly 
unwarranted claim. It certainly has a sense of 
style. Everything is neatly constructed from high- 
quality materials and there’s considerable charm 
to the heat sink. The microSD card slot is easily 
accessible, and a small cut-out on the enclosure 
enables the LEDs to shine through. 


On the box 

One downside to the sealed approach is that the 
GPIO pins are hidden away inside the case. Unlike 
the official case, the lid cannot be quickly removed 
to provide access to the pins. 

To Flirc’s credit, it has addressed this issue viaa 
small gap on the underneath of the Flirc Raspberry 
Pi 4 case, which could be used with a breakout I/O 
cable. But it’s an ungainly addition to such a lovely 
looking case. 

If you plan to use Raspberry Pi as a desktop 
computer, then this might be a valid trade-off. 


However, for many of us, GPIO pins are the very 
essence of Raspberry Pi. 


Under pressure 
We stress-tested a Raspberry Pi 4 board on its own 
vs a Raspberry Pi 4 inside the Flirc case to see what 
temperatures it reported. 

We used stress (apt install stress) and 
the following script from Core Electronics 
(magpi.cc/7Q00X3) to test our Raspberry Pi 4 
while measuring temperature: 


while true; do vcgencmd measure_clock arm; 
vcgencmd measure_temp; sleep 10; done& stress 
-c 4 -t 300s 


This puts all four cores of Raspberry Pi 4 under 
stress. For each test, we left the Raspberry Pi to run 
for five minutes. Warning! Don’t do this at home 
without doing your research first. 

Unsurprisingly, the Raspberry Pi with no heat 
sink attached quickly went up to 79°C and hovered 
at that level for the rest of the test, nudging up 
against (but not pushing over) the level where 
Raspbian starts to throttle the CPU. 


M We're going to experiment 


some more with overclocking, 
which makes this a fun case @ 


Next, we put a Raspberry Pi into the Flirc 
Raspberry Pi 4 case and ran the same test. This 
time it idled at a mere 28°C and our five-minute 
stress test took it up toa mere 46°C. 

Because this is comfortably below the threshold, 
it opens up a world of overclocking (something 
that has been reintroduced on Raspberry Pi 4 - 
see magpi.cc/sED3id). 

We took the CPU clock speed up to 1.75GHz. The 
overclocked Raspberry Pi (inside the Flirc case) 
idled at 41°C, and running our five-minute stress 
test took it up to 67°C. Again, comfortably within 
a threshold. We also played around with CPU clock 
speeds up to 2.0GHz, which idled at 48°C and 
maxed out at 69°C. 

We’re going to experiment some more with 
overclocking, which makes this a fun case. Expect 
a tutorial shortly. Hl 


REVIEW | Magri an 


The case cunningly 
doubles as a heat 
sink, enabling you to 
run your Raspberry 
Pi 4 more coolly 
(and overclock to 
faster speeds) 


Verdict 


We love the style 
of the Flirc case, 
and its heat sink 
opens up a world 
of overclocking. 

If only the GPIO 
pins remained 
accessible. If that's 
not a deal-breaker 
for you, though, 
then this is a great 
case to get. 


8, 10 
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Steam Link 


> Valve » magpi.cc/ZVyieK > Free 


With a change in hardware, does Steam Link streaming suffer or 
improve on Raspberry Pi 4? Rob Zwetloot tests it out 


P Big Picture mode 
is used via the 
Steam Link, which 
is perfect for 
gamepad navigation 


Verdict 


Not perfect, but 
near enough that 
if you have a spare 
Raspberry Pi 4 and 
want to play some 
PC games on your 
TV, there's no 
reason not to give 
it a try! 


8 i 
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The Elder Scrolls V: Skyrim 


PLAY 


MORE ACHIEVEMENTS 


Steam Link app, then maybe the promise of 

new hardware to use it on will be enough to 
get you on board. Essentially, it’s a local network 
streaming service that allows you to stream games 
from a gaming PC to another computer hooked up 
to a screen. There used to be dedicated hardware 
for this, but it has been available for Raspberry Pi 
(and other hardware) for a while now. 

With the release of Raspberry Pi 4 and Raspbian 
Buster, it’s taken some time to get a new version 
of the Steam Link app which works as well as it 
should. Over the last month or so, more stable 
versions have been released, so we thought it was 
time to give it a test. 


[ f you’ve been sleeping on the Raspberry Pi 


Steam Link 

Installing Steam Link is easy — it’s available 
from the Raspbian software repository so can 
be installed from the Terminal with a simple 
sudo apt install steamlink. We highly 
recommend a wired connection for this - and 


FRIENDS WHO PLAY WORKSHOP 


~ - 
= (a 
4 _~2 


yn BZ 


lM Gameplay experience 
was only hampered by 
the computer to which 
we connected @ 


thanks to the Gigabit Ethernet on Raspberry Pi 4, 
it’s going to make a huge difference. 

So much so that our gameplay experience was 
only hampered by the computer to which we 
connected. A WiFi-connected laptop stuttered 
a little, and had some frame tearing; however, 
similar performance is experienced on an actual 
Steam Link. From a dedicated gaming PC hooked 
up over Ethernet, it was a different story. 

While the experience is not seamless and 
one to one, it was extremely good - definitely 
good enough if you have the odd PC game you’d 
rather play on your TV without lugging a massive 
tower around. Hl 


The only guide you 
need to get started 
with Raspberry Pi 


THE OFFIcqay 


aad 


How to use your new computer 


¥ 4 ‘ e Learn how to set up your Raspberry Pi, 
i install an operating system, and start using it 


e Follow step-by-step guides to code your 
own animations and games, using both the 
Scratch 3 and Python languages 


e Create amazing projects by connecting 
electronic components to Raspberry Pi’s 
GPIO pins 


£10 with 
worldwide delivery 
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v Formula Pi 
| 
Self-driving racers 
= A lot of Raspberry Pi robots aren't autonomous - the Formula Pi racers are, 


though: using computer vision and your own bits of code, the aim is to make 
your robot the fastest and most accurate racer. 


Al Dp ice) eC ‘el S > formulapi.com 


Bring your Raspberry Pi to artificial life 
with these machine learning projects 


achine learning and AI are just a normal 
M part of the world now, which in some ways 

is kind of hard to process. On the plus side, 
it means we can have computers do really fun, useful 


(and useless) stuff for us. Here are ten ways to get your 
Raspberry Pi to learn and do. 


v Seeing wand 


Magical item identifier 


This project uses Microsoft's 
Cognitive Services to look at a 
picture for identification. When it 
works, it’s pretty magical; however, it 


Raspberry P? © 
doesn't always work. Still, it will then Chess Robot 


use text-to-speech software to tell 
you what's in front of you. A future 


product for blind people, maybe? A Raspberry Turk 


> magpi.cc/pfpPwB 
a There’s Waldo! Computer chess IRL 


The ‘Mechanical Turk’ was a magic 
trick where chess players would 
manipulate mechanical arms to 
make it look like people were 
facing a machine that could play 
chess. The Raspberry Turk is no 
magic trick - it does it for real. 


Robot cartoon-hunter 


Waldo - or Wally as we call him in the UK - is a very elusive man 
who likes to travel around the world. The puzzle books asking 
young folks to find Wally in a busy crowd of people are very 
popular and can be tricky to solve; that is, unless you're an Al. 


> magpi.cc/gApiTp > raspberryturk.com 


«Cucumber sorter 


Computer-aided vegetable categorisation 


One of the promises of Al is that it can help people out with more mundane 
parts of work. The cucumber sorter allows a farmer to quickly and efficiently 
categorise his cucumber harvest. We've seen it in action and it is fun. 


> magpi.cc/EWpGAp 
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v Autonomous Quadcopter 


Self-driving drone 


This project didn't quite achieve full autonomy for a 
quadcopter/drone, but it got pretty close. Maybe you can build 
upon this design and create incredible aerial spectacles with a 
few drones? 


> magpi.cc/ysuieR 


4 UBC Sailbot 


(4 GPS Receiver N 


Provides current location, 


elevation, heading and 
speed data for processing 


7 


Self-driving boat 


Using GPS and a series of sensors and motor controllers, the Sailbot is one of a 
few autonomous sailing-boats that makes use of Raspberry Pi to control itself in . : ; 
g Peery Radio Receiver Battery Monitor 
races around the world. 6 Radio channels This circuit alerts the operator 
n when the battery is almost 
depleted to allow for a safe 
landing with sufficient power 


tween 


> sailbot.org autonomous & manual contro! 


«Just Keep 
Swimming pons ot ch 


3D control 


Fish-controlled robot tank 


Living in a fish bowl must feel a bit 
limiting. So Alex Kent decided to ' 
allow his goldfish to move with the ¥ Stent -te sting robot 
help of a computer vision project that 
senses where the fish is swimming, 
and moves its tank accordingly. Does 
it notice? Or just forget? Stents are little tubes used to keep a patient's airway open. 

As they are vital, they need to be tested to extremes - this 
robot is able to control clamps that squish and compress the 
stent hundreds of thousands of times and monitor if and when 
it breaks. 


Testing breathable tubes 


> magpi.cc/ihFKyk 


v C-Turtle 


> magpi.cc/nivpET 


Land-mine 
clearing project 


This incredible project uses a 
low-cost robot design to probe 
abandoned (and extremely 
dangerous) minefields by 
sniffing out the mines and 

then detonating them. While this 
does result in each 
robot's heroic demise, 
it's much more cost- 
effective than other solutions. 


> magpi.cc/rKHQmo 
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Learn to code wiih toys 


Play your way to programming prowess, By Lucy Hattersley 


[ Turing Tumble 


e) Alyssa and Turing Tumble is a vertical 

=) Paul Boswell marble game, like a Japanese 

a pachinko machine. Blue and 

e Price: red marbles are loaded to the 
£55 / $70 


top of the board and roll down 
the pins, hitting your switches 
as they go. 

The direction of balls is 
changed via crossovers, ramps, 
and interceptors. Meanwhile, 
logic is simulated via bits (arrows 
that move left or right) and gears 
(which make the board Turing- 
complete). An accompanying 
book has 60 puzzles to solve. This 
board game has a lot of fans at 
Raspberry Pi Towers, and you can 
even pick it up at the Raspberry Pi 
Store in Cambridge. 


turingtumble.com 


Low-tech learning that doesn't cost the earth 


TOWERS OF HANOI and other programming concepts. Check b 

The Towers of Hanoi puzzle is widely available (or out this Code.org teaching resource. 

you can easily make your own). It’s a great way to magpi.cc/sNMBiq 

think about solving a problem with an algorithm, 

and is a classic computer program, as shown in MATCHBOXES 

this Geeks For Geeks course (magpi.cc/DXt233). In the early 1960s Donald Michie, a pioneering 

magpi.cc/aQesb9 British computer scientist, came up with Menace 
(the Machine Educable Noughts And Crosses 

A DECK OF CARDS Engine). It's a great way to learn ultra-modern Al 


You don't need expensive tools to teach coding. A techniques in a low-cost manner. 
deck of cards can be used to discover conditionals magpi.cc/6pw32R 
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B Robo Rally 


Richard 
Garfield 


CREATOR 


For 


Price: 
£40 / $44 
magpi.cc/bwkcig 


younger 
ones 


Designed by Richard Garfield 
of Magic: The Gathering fame 
and first published in 1994, 
Robo Rally is a board game 
where you program robots by 
lining up cards. 

The rules are simple to learn, 
and it’s highly entertaining. The 
aim is to keep your robot alive 


in a dangerous factory while 
trying to ram or shoot other 
players. Rather than a computer 
simulating a board game, it’s 

a board game simulating a 
computer. Each player plays up 
to five cards per turn, and needs 
to plan and sequence ahead if 
they want to win. Hl 


Teach them to code 
from an early age 


ROBOT TURTLES 

Robot Turtles sneakily teaches 
little kids to program computers 
by moving turtles around a 
board game. Players use ‘move’ 
and ‘rotate’ cards to pick up 
jewels on the board. 
robotturtles.com 


8 Parrot Mambo FLY 


Drones are a great toy for 
learning coding skills, 
although picking the right one 
is tricky. Go too high and you'll 
spend a lot of money with a risk 
of being ‘broken by Boxing Day’, 
but go too low and you’ll get a 
toy without any coding nuances. 
Parrot Mambo FLY is our 
pick of the bunch. It’s got an 


advanced flight controller 

and sensors to keep it stable 
when the controls are lost and 
automatically cuts out the 
motors on collision. 

There’s an Android and iPhone 
app, but pah! Check out the 
pyparrot API to get coding your 
drone in Python on a Raspberry 
Pi (magpi.cc/xuaKpT). Hl 


& Parrot 
cm BEE-BOT 
Wi Price: 2 - ae en 
fs £100 / $130 ee-Botisa POnremite e 
magpi.cc/ARmPhL floor robot controlled via a 
——e keypad on its back. It rolls 


around the floor and can 
record and play back audio. 
It moves in 15cm steps and 
rotates by 90° turns. 
magpi.cc/EGDtQt 


CODE-A-PILLAR 

This caterpillar robot is 
reprogrammed by pulling 
apart and rearranging the 
eight segments of its body. It’s 
a fun robot that encourages 
thinking and experimentation 
in toddlers. 

magpi.cc/tiefS6 
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It may be a small 
Raspberry Jam at 

the moment, but the 
Seattle Raspberry Jam 


accepts anyone 


A thermal printing 
instant camera-style 
project, complete 
with a little screen for 


a viewfinder 


magpi.cc 


Alex Mous 


Mous 


A 15-year-old university engineering student, who 
also co-organises a Raspberry Jam in his spare time 


Day job 


ne of the original 

purposes of Raspberry 

Pi was to help ignite 
a passion for computing in 
young people today, and Alex is 
definitely one of these people. 

“In 2014, I received my first 

Raspberry Pi (a Model B+) for 
Christmas,” he tells us. “I started 
out by teaching myself Python 
using the projects in Adventures in 
Raspberry Pi. Using this 
knowledge of Python, I created 


Community role 


several apps (both for Raspberry 
Pi and Windows). After that, I 
became interested in web design. 
I still do a lot of web design today, 
as shown in the recently 
completed coded-from-scratch 
website, eikyutsuho.com. The 
next language I tackled was 
C/C++, and I am still learning 
the ins and outs of it.” 

Five years later and at the age 
of 15, Alex is already working on 
an Associates Degree in Electrical 


URL 


and Computer Engineering, and 
he’s also giving back to the 
community by helping out with 
the Seattle Raspberry Jam. 


Why did you start co-organising 
the Seattle Raspberry Jam? 

I began co-organising the 
Seattle Raspberry Jam in May 
because only a few people were 
showing up to each meeting. I 
thought that with some time 
and effort, I could increase the 


Alex shows off his self-balancing 
robot to the Jam members 


membership to something more 
respectable, such as ten 
members, for example. 


How long has the Jam 

been running? 

A makerspace called Jigsaw 
Renaissance started the Seattle 
Raspberry Jam in August 2013. 
Sadly, in July 2015, the 
makerspace decided that they no 
longer wanted to run the Jam. 
Stephen (my co-organiser) 
started up meetings again in 
August of 2015. I first joined the 
club in mid-2016 (I found out 
about it through the Jam Map). 
[Ed’s note: you can find the map 
on page 90, or at rpf.io/jam. ] 


What kind of attendees do you 
get at the Jam? 

We get just about everyone — 
from seasoned programmers 
who began coding during the 


days of punch cards to first- 
time programmers and 
Raspberry Pi users. People often 
come in confused about how to 
get started with Raspberry Pi, 
and we try to point them in the 
right direction. 


the PolarPiBerry. It uses a 
thermal printer, touchscreen, 
arcade-style button, and 
multiple battery packs (a future 
improvement is to combine the 
power sources) for the hardware, 
and a custom Python WX GUI as 


| am currently working on a self- 
balancing robot for under S50 


The people who do come seem 
to enjoy it. We have just joined 
up with the ideaX Makerspace, 
they are happy to support our 
Raspberry Jam. We’re hoping 
that ideaX Makerspace will give 
our Jam more visibility. 


What’s your favourite Raspberry 
Pi project you’ve made? 

My favourite completed project 
is an instant camera, christened 


the interface with a live stream 
from the camera. 

Iam currently working ona 
self-balancing robot for under 
$50. It uses the cheap yellow 
geared DC motors, an L298 dual 
H-bridge, an MPU6050 IMU, a 
DC-DC boost converter, anda 
6xAA battery pack. I have 
designed and 3D-printed the 


chassis, but I am still working on 


the code. 


Alex Mous 


Seattle 
Raspberry 
Jam 


The Seattle 

Raspberry Jam is a 
monthly event that 
happens every third 
Wednesday of the 
month at the Bellevue 
Library. Entry is free, 
and it’s a great way to 
learn something about 
Raspberry Pi and geek 
out with your fellow 
makers and coders! 
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This Month in 
Raspberry Pl 


Raspberry Pi 


Sp 


ookfest 2019 


People are preparing for Halloween with some excellent projects 


The MagPi, we’re writing this about two 


D ue to the nature of the way we make 


weeks before the magazine comes out on 
Halloween. Even this far into October, though, 
people have got their projects ready and Halloween 
fever is here. Prepare yourselves... Hl 


CoderDojos and Raspberry Jams look like 
they're getting into the spooky spirit 


We love these Scratch-powered scary 
pumpkin lights! 


There are a lot of costumes with eyes this 
year and we're not sure why. They're very 
cool, though 


You might be a little late to get one of these 
this Halloween, but maybe now is a good 
idea to stock up for next year. Buy one here: 
magpi.cc/sKNihf 


Taking store-bought products and hacking 
them with Raspberry Pi is an excellent idea 


. What's cooler than a spooky skull? A 


spooky dinosaur skull.. with moving eyes! 


Another scary eye, this time based on 
Sauron, from Lord of the Rings 
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0» failsworth.uk@coderdojo.com 
@FailsworthUk 


Looking at last years photo's we're pulling together 
some projects ready for next week's Halloween Session 
at @FailsworthUk - We'll have Spooky Scratch, Pumpkin 
Pi (Raspberry Pi really) and some Night Mare MicroBits 
- So come along to @FailsworthLib to try some scary 
coding 


1:10 PM - Oct 19, 2019 - TweetDeck 


( 5) Lacaze Sarah 


Tuto pour #halloween en préparation avec du 
#RaspberryPi et du #scratch 


Translate Tweet 


4 
om , 


Twitter for Android 


ni. The Pi Hut 
( } D>ThePiHut 


Spooky! Introducing the Halloween PumpkinPi @® for 


Raspberry Pi! - mailchi.mp/thepihut/06092... 


MéigPi 


# ) retcherchettian 


My dad's birthday is in October, so built him a 
Halloween Mike Wazowski... @PaintYourDragon 


@adafruit @Raspberry_Pi @Hacksterio 


Fg ethan Seale 


Trying to create fun experiences for the engineering 
club a friend and | started at school. We're doing a tear 
down of this @Target Halloween decoration. It would 
be a great candidate for a Raspberry Pi project! 
#Halloween #RaspberryPi #Hacktober 


Mailchimp 


| mfletcherchristian 


T-Rex Halloween Candy bowl. Shout out to 
@PaintYourDragon for inspiration (and code). This uses 
the same graphics | made for my Eye Of Sauron; sadly, 
the lovely orange color gets washed out in video. 
@Raspberry_Pi @Hacksterio 


£ mfletcherchristian 
nfletcherchristian 


Progress on the Eye Of Sauron... Halloween seems to 
be coming more quickly this year. Not finished yet, it 
still needs more structure and surrounding fire. 
@Raspberry_Pi @Hacksterio @PaintYourDragon 


008 23K views 
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MagP1 Monday 


Amazing projects direct from our Twitter 


01. 


02. 


03. 


04. 


05. 


The tortoise fridge is 
back and being shown 
off at Pi and More in 
Germany next month! 


Remote-controlled 
theatre lights 

that have been 
3D-printed? Now 
that's amazing! 


A robot that will boldly 
go around your living 
room floor 


This full-on weather 
station is one heck 
of a big weekend 
project! Well done! 


We love a good 
Pip-Boy build here, and 
this one is coming 
along nicely 


very Monday we ask the question: have you 

made something with a Raspberry Pi over 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they’ve made. Here is a small fraction of them. 
Follow along at the hashtag #MagPiMonday. 


$ Organ 
@makercupboard 


) @TheMagP 


Raspberry Pi powered 3d printed theatre light 


Fully indulged in the @Raspberry_Pi projects making a 
weather station and creating an loT dashboard 
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Ce] Ciprian Manea 
ows 


The mini Space Shuttle *unPi 


Trehtagh 


MagPi Monday 


Cd PumbatheTurtle 


@TheMagPi 


This weekend i created a presentation for Pl and More 
12 in Trier (Germany). The event opens the doors at 
16.11.2019. | will talk about my Tortoise Fridge. 


@PiAndMore 


) Justin Hart 
hart 
Replying to @TheMagPy 


WIP fallout pipboy... Got everything running, but a long 
way to go yet! 
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INEXPENSIVE © & EASY TO USE! 


FAST RFID COEX Clover 


We've seen a couple of RFID kits available for The COEX Clover is an educational drone 

Raspberry Pi, but they're still not very common. So kit - you build it yourself and it's completely 

this USB-connected RFID reader that works with programmable as well. It can also be used for 

Raspberry Pi is a welcome addition. You can register up racing - drone racing is an amazing sport that 

to five RFID devices with it. you'll find at many maker events. 
kck.st/2VqZ8H1 igg.me/at/coex 


Best of the rest! sere are some other great things we saw this month 


WALL-MOUNTED ARCADE MACHINE | INTERNET RADIO IRL STREAMING BACKPACK 

While we assume this is definitely not the Internet radio projects with Raspberry Pi While not something everyone would like 
first arcade cabinet that is mounted toa aren't too uncommon, but this is definitely to build, we appreciate the effort that's 
wall, it's the first we've seen. The wood one of the better builds we've seen. We gone into this setup. Ever wanted to follow 
panelling and stools give it an excellent like the partial retrofuturistic vibe. someone's Pokémon GO capturing? 


and different aesthetic. 


> magpi.cc/ifbyMS > magpi.cc/Usfrbg > magpi.cc/BCucWJ 
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aspberry Jam 
vent Calendar 


Find out what community-organised Raspberry 
Pi-themed events dre happening near you... 


01. Ibagué Science Raspberry Jam 05. South Devon Tech Jam 

© Thursday 7 November to Friday 8 November ® Saturday 9 November 

9 Universidad Antonio Narifio, Ilbagué, Colombia Q Paignton Library and Information Centre, Paignton, UK 

> magpi.cc/XkRPBp > magpi.cc/9vhGQ5 

A Jam in lbagué to bring students of different levels of A monthly informal and friendly session for anyone 

expertise together to learn about Raspberry Pi. interested in technology, regardless of age or ability. 

02. Cornwall Tech Jam 06. Stafford Raspberry Jam FULL CALENDAR 
© Saturday 9 November © Tuesday 12 November Get a full list of upcoming 
9 Cornwall College Camborne Campus, Redruth, UK Q Stafford Library, Stafford, UK Evontaronniovenbonaned 
> cornwalltechjam.uk > magpi.cc/sWMiLe beyond here: 

For anyone interested in technology, of all ages and A meet-up for folks who have a Raspberry Pi rpf.io/jam 
abilities. Ask questions and learn about programming. computer and want to learn more about it. 

03. Dallas Young Makers Club 07. Seattle Raspberry Jam 

© Saturday 9 November © Wednesday 20 November 

Dallas Public Library, Dallas, TX, USA @ ideaX Makerspace, Bellevue, WA, USA 

> magpi.cc/WTGUep > magpi.cc/bSB7kY 

Free, mentor-led, hands-on projects for kids with A free monthly Raspberry Pi meet-up for beginners and 

Raspberry Pi, Lego Mindstorm robots, and more. experts. Come and participate in the monthly project. 

04. Raspberry Pi Jam DC 08. Raspberry Jam Halifax 

© Saturday 9 November © Tuesday 10 December 

Q Chevy Chase Library, Washington, DC, USA 9 Halifax West High School, Halifax, NS, Canada 

> magpi.cc/wwJyDt > magpi.cc/fpsxLA 

If your children are seven or older, bring them to this one- An event centred around learning about the Raspberry Pi 

hour STEM after-school programme. and sharing projects based on it 
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& 
8 b 

; os. , FIND OUT 
re 3 s@ ABOUT JAMS 
85 & Want a Raspberry Jam 
$ & s 6 é in your area? Want to 

8 3 start one? 
1 BS 6 ; jam@raspberrypi.org 

oe *%, i 
6 


..hU# 
rs) We've highlighted some of the areas & 


in need of a Jam! Can you help out? 


Raspberry Jam advice: 


Fundraising 


4d [ n order to avoid charging for tickets, we 
always hold a raffle and raise between £60 
and £200, and everyone’s happy whether 
they win or not. You can use Twitter to ask for swag 
from the community, to give away as prizes. It’s 
so nice to be able to run community events # Cf 5 


which are free to attend.” pp ? © 
“S. ¢ & ™ 


(er LX; : 
Grace Owolade-Coombes <i Sy me 


South London Raspberry Jam & o a 
ay 


> <B 
“@ RASPBERRY @ 

Every Raspberry Jam is entitled to apply fora 

Jam starter kit, which includes magazine issues, ‘: 

printed worksheets, stickers, flyers, and more. SUIDEBOOK 


Get the book here: rpf.io/guidebook 
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Website updates 


I’ve been an avid reader of The MagPi for a long time now, and also 
enjoy other magazines that you publish, like HackSpace and Custom 
PC. However, I have noticed that they use very different styles of 
website than The MagPi. Is this intentional? Will you be getting a 
website update to match them? I prefer the way they navigate, I 
have to say! I’ll still keep reading the website, though, so keep up 
the good work! 


Jumping into Christmas 


I notice we’re getting towards 
that time of year again... and 
you did have a Halloween 
special... will you be doing 
more Christmas projects 

this year? I do love using my 
Christmas break to make my 


V You can always still place a lot more festive with a 


pint ofr MieIssue Se Raspberry Pi or two. Jon vic email 
cover and make your 
own Christmas card 

Kit vid emai We’ve been beavering away on this for a while now and we’re finally 


happy to say that, at the time this magazine comes out, we have 


However much we try, we a brand new website! We’ve done a rejig of how we present and 


cannot stop our Features 
Editor, Rob, from pitching 
and writing a Christmas 


organise the articles we post, and overhauled the ‘contact us’ form so 
that you can more quickly get in contact with the team that will best 
help you. Give it a look at the same address as always: magpi.cc. 


feature or tutorial each 
year. We think there’s 
something wrong with him. 
He has some more lighting 
plans for Christmas this 
year, though, so you may 
need to get ready to stock up 
on LEDs. 


V We like our new 
website, and we 
hope you do too! 


Buy ree aa 
beers 


Contact us! 


@TheMagPi 


Oowniond free Poe 


> Twitter 


> Facebook magpi.cc/facebook 


magpi@raspberrypi.org 
raspberrypi.org/forums 


> Email 
> Online 


92 | magpicc | Your Letters 


YOUR LETTERS | Mag?t 


New learning 


Will there be new course on FutureLearn 
from Raspberry Pi any time soon? I like 
the courses already up there and would 
like to learn more! 


Lee via Twitter 


Yes, there are three brand new, free 
courses being launched by the Raspberry 
Pi Foundation on FutureLearn starting 
now! Here are the new courses... 

* Design and Prototype Embedded 
Computer Systems: in this course, you 
will discover the product design life cycle 
as you design your own embedded system. 

¢ Programming 103: Saving and 
Structuring Data: this explores how to use 
data across multiple runs of your program. 

¢ Introduction to Encryption and 
Cryptography: In this course, you’ll learn 
what encryption is and how it was used 
in the past, and you’ll use the Caesar and 
Vigenére ciphers. 

The last course is still under 

development, so check back for a 
release date. 


A Here is Igalia's Continuous Integration system that's used for running regression tests 


Open graphic drivers 


Se 


pnal 


‘\ 


Has there been any recent news about the open-source 
versions of the graphics drivers for Raspberry Pi’s 
VideoCore? Also, is there any word on whether the new 
VideoCore in Raspberry Pi 4 will have open-source drivers as 
well? I assume VideoCore VI uses a different set of drivers. Test 


iterative 
design 
life cycle 


Christine via email 


You’re in luck Christine, as there was recently a big update on 
the VideoCore drivers you can find on the Raspberry Pi blog 
here: magpi.cc/CyxynC. 

A brief summary is that a new team from Igalia is working 
on the open-source drivers. You’re right in thinking that 
VideoCore IV and VI have different drivers — they’ re referred to 
as VC4 and V3D respectively. The team have been working on 
getting to know the hardware, and have made some advances 
in the last few months including shader optimisations, 


Builg 


support for OpenGL Logic Operations, as well as support for A pads ee 
OpenGL ES 3.1. Work isn’t finished yet, but it is progressing! dev cycle 
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COMPETITION | Magri 


SMARTIPI TOUCH 2 
FOUCHSCREEN 
CASE 


The original SmartiPi was a 
great case that made use 
of the official Raspberry Pi 
Touch Display, and this new 
version includes a specific 
mount for a camera, a 
Lego-compatible faceplate, 
and a little cooling fan. 


In association with The Pi Hut 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/pGSpYM 


Terms & Conditions 


Competition opens on 30 October and closes on 28 November 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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A new golden age 


The arrival of Raspberry Pi sparked a renewed interest 


Thad my first encounter with 

a computer. A teacher friend 
of my mum’s — Miss Horsburgh, 
who also made superb shortbread 
biscuits — had kindly offered to 
show me her new Commodore PET. 
Compared to today’s computers, it 
now looks incredibly primitive with 
its small green screen and floppy disk 
drive, but back then it was cutting- 
edge technology and I was totally 
enthralled by what it could do. I recall 
playing simple games, like Nightmare 
Park (magpi.cc/QwujhD), which had 
ASCII characters for graphics. 

I was hooked and soon wanted a 
computer of my own. After persuading 
my parents that it would help me 
with my school homework (that old 
chestnut), I was incredibly excited 
to unwrap a Sinclair Spectrum on 
Christmas Day 1982. While I never 
did use it for homework, it was my 
dream machine, complete with colour 
graphics, beepy sound, a rubber 
keyboard, and a massive 16kB of RAM. 


| t was in the early 1980s when 


Electric dreams 

As well as playing lots of games 

on my Spectrum — including those 
laboriously typed in, line by line, 
from magazines — I did get round to 
doing some BASIC programming. I 
was heavily into Dungeons & Dragons 
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in computing for Phil King 


at the time and decided to code a 
computerised character generator. 
Even though it was fairly simple - 
simulating the throwing of various- 
shaped dice to generate elves, clerics 
and so on, with their alignments 
and abilities — I felt a great sense of 
accomplishment at having created it. 
I dreamt of becoming one of the 
“bedroom programmers’ of the time, 
who were single-handedly creating 
commercial games. While I never 
managed to fathom the complexities 


all the time. I now have numerous 
Raspberry Pi devices scattered around 
the home, including an air quality 
monitor, TV streamer, wildlife 
camera, and several wheeled robots. 
It’s not just the ability to do 
physical computing with Raspberry Pi 
that’s impressed me: I’ve discovered 
that slick-looking games can be 
created with just a few hundred 
lines of code using Pygame Zero - as 
demonstrated in Mark Vanstone’s 
recent tutorial series for The MagPi. 


M | now have numerous Raspberry Pi devices 
scattered around the home @ 


of Z80 assembly language, I did 
eventually write a basic shoot-’em- 
up — in BASIC, sped up by using a 
compiler. As a puerile teenager, I even 
did a version with rude graphics. 


Back to the future 

After that, I forgot all about 
programming for years... until the 
arrival of Raspberry Pi. What grabbed 
me in particular was the ability to 
hook up electronic components and 
control them with code. Flashing my 
first LED was a genuine thrill and I’ve 
since dabbled with all sorts of lights, 
sensors, and add-on boards. I’m 
certainly no expert, but I’m learning 


While it’s all a far cry from the 
primitive technology of those early 
computing days, I feel it’s recapturing 
the spirit of that era. Once again, 
amateur programmers and makers 
are beavering away and being 
creative, often sharing their code and 
advice freely with others thanks to 
the open-source ethos. It really isa 
new golden age. 


Phil King 


When not editing books for Raspberry Pi 
Press, Phil enjoys dabbling with coding and 
attempting to do the Listener crossword. 
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© Oll Tank — Pump 622 
© Oll Tank — Seal 5 
> Vibration Sensors 
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¥ Asset Croup Neme 
O Asset! 
5 Asset 2 
v CAMERAS 
¥ Overview Cameras 
> Overview 1 (X-Ray View) 
> Overview 2 (X-Ray View! 


> Sensor Cameras 
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Temp » than 33° F 


Temp > avg. tmp over 2 weeks 
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Visualize actionable data on 3D 
models from all your Raspberry 
Pi sensors. 


UrsaLeo technology takes Raspberry Pi sensor data and 
displays it on 3D models of any environment, visualizing 


alerts and lending context to help guide your business. 


Y Import your environment with a CAD drawing (Sketch Up, AutoCAD 
or similar) or start with photographs and measurements 


Y Zoom, pan and rotate through a fully rendered 3D model that 
combines your data with our software 


Y Easily place your sensor locations in the environment and define 
metadata for each one 


/Y Define camera viewpoints for each sensor 

¥ Set up alerts based on incoming data 
« Assign status colors to visualize sensor and asset information 
¢« Automatically jump to view any sensor generating an alert 


Y Multiple visualizations available, such as X-ray, rewind and replay, with more coming soon 


GREAT FOR 


INDUSTRY 4.0 + EDUCATION + BUILDING MANAGEMENT 


Get started today 
www.ursaleo.com/platform 


rl 


VILROS 


RASPBERRY Pi 4 
THE SHOWSTOPPER 


AVAILABLE NOW AT VILROS 


- Faster & more powerful Fully stocked with 
- RAM options: 1GB/2GB/4GB Raspberry Pi 4 boards, 
- Fast networking kits & accessories. 


SCAN NOW TO BUY >>> & 


